GeoDataSource Location Search

Name: GeoDataSource Location Search API
Brand: GeoDataSource Location Search
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMaps GeolocationGeocodingnone1 EndpointsREST

For Agents

Reverse-geocode a latitude and longitude pair to a city, region, and country via a single lightweight lookup endpoint.

Install Jentic One Beta

Connect the GeoDataSource Location Search to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GeoDataSource Location Search, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with GeoDataSource Location Search API.

Convert latitude and longitude into a city name with /city

Receive country and region context for a coordinate alongside the city

Choose JSON or XML response format for downstream consumers

GET STARTED

Start building with GeoDataSource Location Search API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for GeoDataSource Location Search, keeping it validated and agent-ready. GeoDataSource is a lightweight reverse-geocoding service that accepts a latitude and longitude and returns the city, region, and country for that coordinate, in either JSON or XML. The single /city endpoint is intended as a fast, low-friction lookup for analytics dashboards, simple location enrichment, and fallback paths in larger geocoding stacks. Authentication and other operational details are handled per the vendor's own documentation rather than through the spec.

Use Cases

Patterns agents use GeoDataSource Location Search API for, with concrete tasks.

★ Analytics Dashboard Enrichment

Product teams enrich web analytics events that already contain a coordinate (from IP geolocation or browser geolocation) with a human-readable city name. The /city endpoint converts each coordinate to a city/region/country triple and the values feed directly into a BI dashboard slice without needing a heavy geocoding stack.

For each session in the events table, call /city with the lat/lng and store the returned city name in the enriched analytics row

Fallback Geocoder

Engineering teams running a primary geocoder (Geocodio, Google, HERE) want a cheap fallback when the primary rate-limits or fails. GeoDataSource's single endpoint is dependency-light and returns the coarse city/region/country needed to keep most user-facing flows alive while the primary cools down.

On a 429 response from the primary geocoder, retry the lookup against /city and use the city/region/country result to keep the request flowing

Compliance Region Routing

Apps with regional compliance requirements decide which data residency region to use based on a user's country. /city returns the country alongside the city for a given coordinate, enabling a routing layer to choose an EU vs US backend without standing up a full geocoding service.

On signup, call /city for the user's coordinate and route the account to the EU backend when the response country is in the EEA

AI Agent Location Context

An AI agent answering location-shaped questions can call GeoDataSource through Jentic for a quick city lookup. Because the /city endpoint takes only lat/lng, the agent can produce a 'this user is in Paris, FR' style answer with a single search-load-execute cycle.

Search Jentic for 'reverse geocode a coordinate to city', execute /city with 48.8566,2.3522, and return 'Paris, Île-de-France, France' to the chat thread

Key Endpoints

1 endpoints — jentic publishes the only available openapi specification for geodatasource location search, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/city

Reverse-geocode a latitude and longitude to a city, region, and country

GET

/city

Reverse-geocode a latitude and longitude to a city, region, and country

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Any GeoDataSource credentials needed at runtime are stored encrypted in the Jentic vault and attached to outgoing /city calls at execution time. Even for an open or query-string-keyed API, the secret never enters the agent's context.

Intent-based discovery

Agents search by intent ('reverse geocode a coordinate to a city') and Jentic returns the /city operation with its parameter schema (latitude, longitude, format), so the agent calls the right endpoint without browsing GeoDataSource docs.

Time to first call

Direct GeoDataSource integration: a couple of hours to wire the single endpoint and parse the response. Through Jentic: under 15 minutes — search, load, execute.

FAQs

Specific to using GeoDataSource Location Search API through Jentic.

Why is there no official OpenAPI spec for GeoDataSource Location Search?

GeoDataSource does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call GeoDataSource Location Search via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the GeoDataSource API use?

The OpenAPI spec does not declare a security scheme — authentication is handled per the vendor's web-service documentation, typically a key passed as a query parameter on the call. When integrating through Jentic, store any required key in the vault so it is injected at execution time.

Can I get JSON output from GeoDataSource?

Yes. The /city endpoint supports both JSON and XML output formats — request JSON with the appropriate format query parameter to receive a structured response with city, region, and country fields.

What are the rate limits for the GeoDataSource API?

The OpenAPI spec does not declare explicit rate limits. GeoDataSource meters usage by plan on its website — for production workloads, batch lookups, cache the city result per coordinate, and confirm the plan ceiling before backfilling large coordinate tables.

How do I reverse-geocode a coordinate through Jentic?

Run pip install jentic, search Jentic for 'reverse geocode a coordinate to city', and call /city with the latitude and longitude as query parameters. The response contains the city, region, and country corresponding to the point.

When should I choose GeoDataSource over a full geocoder?

Choose GeoDataSource when you only need a coarse city/region/country lookup at low cost — for analytics enrichment, fallback paths, or compliance routing. For street-level forward geocoding, address validation, or routing, use a full geocoder like Geocodio or HERE.