Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Free, open source, and ready to use geocoder, reverse geocoder and geolocalisation webservices

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, Openaddresses, 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


demo on map (leaflet plugin)

[play with webservices] (

gisgraphy web site

About us

Since 2006, Gisgraphy's goal is to provide a realistic alternative for geocoding and geolocalisation. Feel free to contact us at contact[at]

Install it locally

We got Docker images and installation scripts. read the installation guide to set up Gisgraphy on you own server.

Webservices overview :##

All the webservice are world wide (243 countries) and support pagination. Actually there are 6 (web)services, and all are availables for free at (c). It also gives some HTML pages that uses the webservices under the hood. Find bellow a summary for each webservices :


Provide an address, structured or not, and get it's GPS position. Worldwide coverage, including house numbers of more than +410 million addresses.

Doc | Demo | Free access

Reverse geocoding

Provide a GPS position and get the corresponding address. Worldwide coverage, including house numbers of more than +410 millions of addresses.

Doc | Demo | Free access

Street search

Find streets for a given GPS point (and an optional name). Speed-limit, number of lanes, toll or not, surface type, azimuth, etc. For GTS tracking software (e.g : Open GTS or Traccar), but lot of other use cases.

Doc | Demo | Free access


Find places, POIs, cities, streets around a GPS point for a given radius. Results include and can also be sorted by the distance from the given point. 230+ POIs type availables (e.g : restaurant, station, ATM, PostOffice, Doctor, Parking, tourist information office). Very powerfull when coupled with the reverse geocoding service to find place around an address.

Doc | Demo | Free access

Fulltext search / Autocompletion

For a given text and an optional GPS point, find places, POIs, cities, streets, zip codes,...with its information (coordinates, states, population, elevation, alternate names in many languages and alphabet). Many options availables : Auto completion (as you type), location bias, fuzzy, spell checking, all words required or not, place type filtering,...

Doc | Demo | Free access

Address parser

Divide a single address (as a string) into its individual component parts : house number, street type (directional, street, ..), street name, unit (apt, building, ...), zip-code, state, country, city. Manage PO boxes and address format in 60+ countries. This software is not open source and can be used on-line as a web-service or a license can be purchased for an unlimited off-line use

Doc | Demo | Free access

Addresses / pois / street database in CSV

We have built a unique and worldwide address, POIs (point of interest), streets, cities, and administrative divisions databases of 500+ millions entries.

Available country per country and in CSV or SQL format to simplify things. We use open data from best open data sources : Openstreetmap, Openaddresses, Geonames, Quattroshapes.

You can order our address database (or street, cities and administrative division ones) in CSV/TSV format.Read more


Gisgraphoid is a library to do geocoding on your Android mobile or tablet with the same Geocoder API as Google but with Gisgraphy. Run on all Android versions, free, no Google API needed by the phone, no API key, no limit. You can display the result on Openstreetmap or Google maps (Google API key required)

Learn More | Download library | Download Demo app

Leaflet Plugins

Demo with the two plugins on a map.

Geocoding : It allows to add a geocoding to add a geocoding input with autocompletion on a leaflet map. It wraps the Gisgraphy js API.

Learn More | View demo | Documentation

Reverse geocoding : It reverse geocode when you rightclick on the map. it is a sample and you can personalize it.

Learn More | View demo | Documentation

A little bit further

  • Importers from geonames / openstreetmap, openaddresses, quattroshapes files. Just give the country(ies) you wish to import and / or the placetypes, and Gisgraphy download the files and import them with all the alternate names (optional) and sync the database with a fulltext search engine Leaflet plugins
  • WorldWide geocoding / worldWide reverse geocoding / street search WebServices;
  • REST WebService
  • Several output formats supported : XML, json, PHP, ruby, python, Atom, RSS / GeoRSS
  • Full text search (based on Lucene / Solr with default filters optimized for city search (case insensitivity, separator characters stripping, ..) via an Java API or a webservice
  • Findnearby function (with limits, pagination, restrict to a specific country and/or language and other useful options) via a Java API or a Web Service
  • An admin / back office whith statistics interface
  • Fully replicated / scalable / high performances / cached services
  • Search for zipcode name, IATA, ICAO
  • Internationalized (with support of cyrillique, arabic, chinese,... alphabet)
  • Dojo widgets / prototype / Ajax to ease search but can be use it even if javascript is not enabled on the client side
  • Opensearch module
  • Plateform / language independent
  • Provides all the countries flags in svg and png format
  • ...

License and attributions


geocoding and geolocalisation webservices for Geonames, Openstreetmap, Openaddresses, Tiger and quattroshapes data




LGPL-3.0 and 2 other licenses found

Licenses found






No releases published


No packages published