Gisgraphy

Gisgraphy webservices

Since 2006, [Gisgraphy](http://www.gisgraphy.com) is a free, open source framework that offers the possibility to do geolocalisation and geocoding via Java…

Maps & location#openapi#location

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Since 2006, Gisgraphy 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, Geonames and Quattroshapes: 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

if you use the premium servers, you can use the api key to test the webservices

Endpoints 6

addressparser - standardizer

  • GETsplit a raw address into several parts/addressparser/parse?address=string&country=string&format=XML&callback=string&indent=false&standardize=false&geocode=falseThe address parser and address standardizer, are part of the Gisgraphy project (free open source worldwide geocoder). Address parsing is the process of…

fulltext - autocomplete

  • GETsearch for places by text around a GPS point/fulltext/search?q=string&allwordsrequired=false&spellchecking=string&lat=0.0&lng=0.0&radius=10000&suggest=false&style=MEDIUM&country=string&lang=string&format=XML&from=1&to=10&callback=string&indent=falseThe full text service allows you to search for features / places / street and do autocompletion . you can : Specify one or more words search on part of the…

geocoding

  • GETGeocode an address/geocoding/geocode?address=string&country=string&postal=string&format=XML&from=1&to=10&callback=string&indent=falseThe Gisgraphy geocoding service allows you to transform postal addresses or other descriptions (a street, a city, a postal code, a country, or a combination)…

geolocalisation

  • GETGeocode an address/geoloc/search?lat=0.0&lng=0.0&radius=10000&distance=true&placetype=string&format=XML&from=1&to=10&callback=string&indent=falseThe geolocalisation service allows to search for features around a earth location. you can Specify GPS position, Limit the results to a specific place type…

reversegeocoding

  • GETReverse geocode an address/reversegeocoding/reversegeocode?lat=0.0&lng=0.0&format=XML&from=1&to=10&callback=string&indent=falseThe Reverse geocoding service allows to search for an address for a given GPS position.

streetservice

  • GETGeocode an address/street/find?lat=0.0&lng=0.0&radius=10000&oneway=false&distance=true&streettype=string&format=XML&from=1&to=10&callback=string&indent=falseThe street service allows you to search for street by GPS position. You can : Specify GPS position, Give the beginning or a part of the name of the street…

API details

Base URL
https://free.gisgraphy.com
Authentication
An API key in the api_key query parameter
Operations
6 operations on 6 pathsGET 6
Main resources
addressparser - standardizer 1fulltext - autocomplete 1geocoding 1geolocalisation 1reversegeocoding 1streetservice 1
Description format
Swagger 2.0, API version 4.0.0
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the Gisgraphy webservices in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Gisgraphy webservices collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the api_key query parameter. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “split a raw address into several parts” (GET /addressparser/parse?address=string&country=string&format=XML&callback=string&indent=false&standardize=false&geocode=false), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Gisgraphy webservices?

Since 2006, [Gisgraphy](http://www.gisgraphy.com) is a free, open source framework that offers the possibility to do geolocalisation and geocoding via Java… It is listed under Maps & location and has 6 endpoints.

Who publishes the Gisgraphy webservices?

It is listed from Gisgraphy's public API description (an OpenAPI document), not published by Gisgraphy on Swastik Codes. Anyone who controls gisgraphy.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Gisgraphy webservices?

Requests go to https://free.gisgraphy.com. Endpoint paths are added to this base URL.

How do I authenticate with the Gisgraphy webservices?

With an API key in the api_key query parameter.

How many endpoints does the Gisgraphy webservices have?

6 operations on 6 paths (6 GET). The largest groups are addressparser - standardizer, fulltext - autocomplete, geocoding, geolocalisation.

Is forking the Gisgraphy webservices free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.