ResearchCave.Location.Client (1.0.0)
Installation
dotnet nuget add source --name ResearchCave --username your_username --password your_token https://git.researchcave.com/api/packages/ResearchCave/nuget/index.jsondotnet add package --source ResearchCave --version 1.0.0 ResearchCave.Location.ClientAbout this package
Typed service-discovery client for the ResearchCave Location authority.
ResearchCave.Location.Client
Register the client with services.AddResearchCaveLocationClient(configuration).
Configure DownstreamServices:Location:BaseUrl, normally https+http://location,
and OIDC client credentials permitted to request location.lookup, location.write,
and, where needed, location.map.
Use ILocationClient.GetCurrentAsync(subjectId) for one user or the collection
overload for up to 100 users. Calls are made only when the consuming service invokes
the client; the library does not perform background or login-time lookups.
Maps should use the MapViewportRequest overload. It sends the trusted viewer,
accepted-friend subjects, active subjects, viewport bounds, and zoom to Location.
Location applies privacy and clustering before returning data; consumers must not
offset or regroup the response.
Distance-sorted member discovery should use GetNearbyUsersAsync. Location enforces
the hard 1,000 km ceiling, location age, observation visibility, and each member's
privacy mode. The result intentionally contains distances but no coordinates.