Gisgraphy webservices API

Overview

Since 2006, [Gisgraphy](http://www.gisgraphy.com) is a free, open source framework that offers the possibility to do geolocalisation and geocoding via Java APIs or REST webservices. Because geocoding is nothing without data, it provides an easy to use importer that will automatically download and import the necessary (free) data to your local database ([OpenStreetMap](http://www.openstreetmap.org/), [Geonames](http://www.geonames.org/) and [Quattroshapes](http://www.quattroshapes.com/): more than 100 million entries). You can also add your own data with the Web interface or the importer connectors provided. Gisgraphy is production ready, and has been designed to be scalable(load balanced), performant and used in other languages than just java : results can be output in XML, JSON, PHP, Python, Ruby, YAML, GeoRSS, and Atom. One of the most popular GPS tracking System (OpenGTS) also includes a Gisgraphy client...Gisgraphy is a framework. As a result it's flexible and powerful enough to be used in a lot of different use cases. [read more](http://www.gisgraphy.com) if you use the premium servers, you can use the api key to test the webservices

Gisgraphy webservices is a geocoding API from gisgraphy.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 6 endpoints.

At a glance

Authentication

API key

HTTPS

Yes

CORS

Unknown

Category

Geocoding

Base URL

http://free.gisgraphy.com/

Version

4.0.0

Endpoints

6

OpenAPI

Specification ↗

Spec updated

2021-06-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

curl -X GET "http://free.gisgraphy.com/addressparser/parse" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch("http://free.gisgraphy.com/addressparser/parse", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);

import requests

response = requests.request(
    "GET",
    "http://free.gisgraphy.com/addressparser/parse",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

Questions