Gisgraphy webservices

Name: Gisgraphy webservices API
Brand: Gisgraphy webservices
Availability: InStock

✓ Official Vendor SpecMaps GeolocationGeocodingapiKey6 EndpointsREST

For Agents

Geocode addresses, reverse-geocode coordinates, parse address strings, and search for nearby places using Gisgraphy's open-source webservices.

Install Jentic One Beta

Connect the Gisgraphy webservices to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Gisgraphy webservices, 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 Gisgraphy webservices API.

Geocode a street address into latitude and longitude via /geocoding/geocode

Reverse-geocode a lat/lng pair into the closest address via /reversegeocoding/reversegeocode

Parse free-form address strings into structured components via /addressparser/parse

GET STARTED

Start building with Gisgraphy webservices API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Gisgraphy webservices API for, with concrete tasks.

★ Address Form Autocomplete

Power a checkout or signup form with structured address suggestions backed by OpenStreetMap data. The /fulltext/search endpoint returns places matching a partial query, and /geocoding/geocode resolves the chosen suggestion into precise coordinates for delivery routing.

Call /fulltext/search with q='1600 Pennsylvania' and country=US, then geocode the top suggestion via /geocoding/geocode

Delivery and Logistics Routing

Convert customer-supplied addresses into coordinates for routing and dispatch. /geocoding/geocode returns lat/lng plus admin-level breakdown, and /reversegeocoding/reversegeocode resolves driver pings back into human-readable street addresses for delivery proof.

Reverse-geocode lat=51.5034 lng=-0.1276 via /reversegeocoding/reversegeocode and return the formatted street address

Local Search for a Mobile App

Show points of interest near a user's location in a mobile app. /geoloc/search accepts a lat/lng centre and a radius, returning OpenStreetMap features sorted by distance — restaurants, parks, transit stops — without licensing fees from a commercial maps provider.

Call /geoloc/search with lat=40.7128 lng=-74.0060 radius=500 and placetype=Restaurant; return the names of the five closest results

AI Agent Address Parsing

Let an AI agent normalise free-form address strings collected from email, chat, or scraped data. The agent issues an intent like 'parse a postal address', Jentic resolves the /addressparser/parse call, executes it, and returns structured fields the agent can validate or store.

Through Jentic, call /addressparser/parse with address='Apt 4B 221 Baker Street London NW1' and return houseNumber, streetName, and city

Key Endpoints

6 endpoints — gisgraphy is an open-source geocoding and geolocation framework that exposes rest webservices for forward and reverse geocoding, address parsing, full-text search, nearby place search, and street lookup.

METHOD

PATH

DESCRIPTION

GET

/geocoding/geocode

Forward geocode an address to coordinates

GET

/reversegeocoding/reversegeocode

Reverse geocode coordinates to an address

GET

/addressparser/parse

Parse a free-form address string

GET

/fulltext/search

Full-text search across places and admin areas

GET

/geoloc/search

Find features within a radius of a coordinate

GET

/street/find

Look up street segments

GET

/geocoding/geocode

Forward geocode an address to coordinates

GET

/reversegeocoding/reversegeocode

Reverse geocode coordinates to an address

GET

/addressparser/parse

Parse a free-form address string

GET

/fulltext/search

Full-text search across places and admin areas

GET

/geoloc/search

Find features within a radius of a coordinate

Why Jentic?

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

Credential isolation

Gisgraphy api_key values for premium servers are stored encrypted in the Jentic vault (MAXsystem). Agents receive a scoped execution token, and the free server can be called with no credential required.

Intent-based discovery

Agents search by intent (e.g. 'geocode an address') and Jentic returns the matching Gisgraphy operation with its query parameter schema, so the agent can call /geocoding/geocode or /addressparser/parse without reading docs.

Time to first call

Direct Gisgraphy integration: a few hours to host or wire up to free.gisgraphy.com and parse the JSON response. Through Jentic: under 15 minutes — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

MapQuest API

Commercial geocoding, routing, and search built on OSM and proprietary data

Choose MapQuest when the agent needs routing, traffic, or commercial-grade SLAs that Gisgraphy's free tier does not promise.

Alternative

HERE Maps API

Enterprise mapping with global address coverage and traffic data

Choose HERE when the agent must geocode commercial addresses with enterprise SLAs and global coverage guarantees.

Alternative

LocationIQ API

Hosted OpenStreetMap-backed geocoding with free and paid tiers

Choose LocationIQ when you want OSM-based geocoding with a managed SLA rather than the community free.gisgraphy.com endpoint.

Alternative

Positionstack API

Forward and reverse geocoding with 25k free monthly requests

Choose Positionstack when a hosted commercial geocoder with a clear monthly free quota fits the project better than self-hosted Gisgraphy.

FAQs

Specific to using Gisgraphy webservices API through Jentic.

What authentication does the Gisgraphy API use?

The free server at free.gisgraphy.com is open and does not require credentials. Premium servers accept an api_key query parameter for higher quotas. Through Jentic the api_key is stored encrypted in the MAXsystem vault and only injected at execution time.

Can I geocode an address with the Gisgraphy API?

Yes. Call GET /geocoding/geocode with address and country to convert a postal address to coordinates. The response includes lat, lng, formatted address, and the matched admin levels (city, state, country) drawn from OpenStreetMap data.

What are the rate limits for the Gisgraphy API?

The free tier on free.gisgraphy.com is best-effort and may throttle aggressive clients without a fixed published cap. Production deployments should host Gisgraphy themselves or use the premium servers, which are sized to the subscription tier.

How do I reverse-geocode coordinates through Jentic with Gisgraphy?

Search Jentic for 'reverse geocode coordinates', load the GET /reversegeocoding/reversegeocode schema, and execute with lat and lng. The response returns the closest street address along with admin-level fields drawn from the underlying OpenStreetMap dataset.

What data does Gisgraphy use under the hood?

Gisgraphy ingests OpenStreetMap, GeoNames, and Quattroshapes — more than 100 million entries — into a Solr-backed search index. That makes it suitable for a Google-Maps-free or Mapbox-free deployment when licensing is the dominant constraint.

Is the Gisgraphy API free?

Yes. Both the framework and the free public server are released under an open-source licence with no usage charge. Paid premium servers exist for users who need higher quotas, an SLA, or commercial support beyond what the open community endpoint provides.