Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing

GET STARTED

API DirectoryBrowse 10,000+ APIs ready for AI agent integrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI readiness using our scorecardArazzo UIVisualize Arazzo workflows as interactive documentationArazzo EditorBuild and edit multi-step API workflows visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
All ResourcesEverything in one placeBlogLatest articles and insightsTech Talk NewsletterAPIs, AI agents, architecture and strategyWebinarsLive sessions and on-demand recordingsReports & WhitepapersOriginal research on enterprise AI
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
All ResourcesBlogTech Talk NewsletterWebinarsReports & Whitepapers
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / Maps Geolocation / GeoDataSource Location Search
GeoDataSource Location Search logo

GeoDataSource Location Search

59
AI ReadinessFoundational (C+)59/100
See full scorecard
Agent-ready OpenAPI document · curated by JenticMaps GeolocationGeocodingnone1 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

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

Use for: I need to find the city at latitude 40.7128 and longitude -74.0060, Get the country for a given coordinate pair, Reverse geocode a lat/lng to a city name only, Find which city corresponds to a user IP coordinate

Not supported: Does not handle forward geocoding, routing, or street-level address resolution - use for coordinate-to-city reverse lookup only.

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.

Jentic One on GithubView OpenAPI Document

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.

1

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgeodatasource.com%2Fgeodatasource" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgeodatasource.com%2Fgeodatasource" | 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

Use as a low-cost fallback when a primary geocoder rate-limits or fails

Enrich session logs with a coordinate-derived city name for analytics dashboards

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

Jentic AI Readiness Score

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

G

GeoDataSource Location Search

- Foundational (C+)
59/100
100
Foundational Compliance
59
Developer Experience & Jentic Compatibility
30
AI-Readiness & Agent Experience
94
Agent Usability
100
Security
100
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
100

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A+Signals: 4
99%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

100%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

59

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: C+Signals: 4
10%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

25%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

30

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: FSignals: 4
19%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

0%

Summary Coverage

Coverage of summaries across operations/tags/info.

94

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1
94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

100

Security

Trust, risk posture, and security compliance.

Grade: A+Signals: 1
100%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

100

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: A+Signals: 1
100%

Descriptive Richness

Clarity and depth of descriptions across API elements.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the GeoDataSource Location Search API by hand means constructing the /city request with latitude, longitude, and format parameters and parsing the reverse-lookup response yourself. Through Jentic you install once, import GeoDataSource from the API Directory, store any required credential once, and your agent calls it.

Permission scoping

GeoDataSource exposes a single reverse-lookup operation that takes its coordinates in the query string, so scope the agent to just the operation it needs. You choose the operations it may call, so nothing beyond coordinate-to-city lookup runs unless you add it.

Credential isolation

Any GeoDataSource credential is stored once, encrypted, by your own Jentic One instance and attached to the /city call at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

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

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

OpenCage

→

Worldwide forward and reverse geocoding aggregating multiple open data sources

Choose OpenCage when you need richer reverse-geocoding output (timezone, postcode, formatted address) than GeoDataSource's coarse city result

Alternative

Positionstack

Forward and reverse geocoding API with bulk and single-request modes

Choose Positionstack when you need both forward and reverse geocoding rather than just coordinate-to-city lookup

Complementary

HERE Maps

→

Maps, routing, and traffic to pair with the city result for richer location experiences

Pair HERE with GeoDataSource when you need to route from or render the resolved city on a map

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 with Jentic One, the self-hosted execution layer.

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.

Can I limit what my agent is allowed to do with the GeoDataSource API?

Yes. Because GeoDataSource exposes only a single reverse-lookup operation, the /city endpoint that turns a latitude and longitude into a city, region, and country, you scope your agent to just that call and nothing else runs. Since Jentic One is self-hosted, your own rules on your instance decide which operations and credentials the agent may use, so you can allow the coordinate-to-city lookup while withholding everything else. Any required GeoDataSource key is stored on your instance and attached to the /city request at execution time rather than exposed to the agent.

GET STARTED

Start building with GeoDataSource Location Search API

Explore with Jentic One
View OpenAPI Document