Fork me on GitHub

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

Gisgraphy : Easy geocoding for humans !

Since 2006, Gisgraphy has been a free, open source framework (except the Address parser that is not open source) that offers the ability to do geolocalisation and geocoding via Java APIs or REST webservices. Because geocoding is nothing without data, Gisgraphy 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 import connectors provided. Gisgraphy is production ready, and has been designed to be scalable (load balanced), high performance and is able to be used in other languages other than just Java : results can be output in XML, JSON, PHP, Python, Ruby, YAML, GeoRSS, or Atom. some popular GPS tracking System (OpenGTS or Traccar ) 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
Try it ▸▸    Get started ▸▸ 

NEW : Check Gisgraphy's accuracy by comparing results from several geocoders

What's new :

  • Gisgraphy V 4.0 is out! It now manages house numbers, has 100% more data, better relevance, country codes are not required anymore, and SOOOOO much more.
  • Gisgraphy is candidate for the Dataconnexions competition, launched by the French government via the ETALAB mission. The goal is to promote the use of open data and encourage projects that use it.
  • To follow the one version / per year (and after more than one year of development), I am proud to announce that the Version 3.0 of Gisgraphy is now available. It is a major version where a LOT of functionalities have been added. See Why you should update... You can try it here.
  • Read more news

Webservices overview :

All the webservices are world wide (243 countries) and support pagination. Actually, there are 6 (web) services, and all are available for free at We also provide some HTML pages that uses the webservices under the hood. Below is a summary for each webservice:
  • Geocoding

    Provide an Address, structured or not, and get it's GPS position in 243 countries.
  • Reverse geocoding

    Provide a GPS position and get the corresponding address
  • Street search / tracking

    Find streets and associated information for a given GPS point (and an optional name). It is very useful for tracking software like Open GTS or Traccar, but there are a lot of other use cases.
  • Find nearby

    Find places, streets or whatever you want around a GPS point for a given radius. Results can be sorted by distance.
  • Fulltext search / Autocompletion

    For a given text and an optional GPS point, find places, POIS, cities, streets, zip codes,... with information (coordinates, states, population, elevation, alternate names in many languages). Auto completion, location bias, spellchecking, all words required or not...
  • 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, ...), zipcode, state, country, city.
Gisgraphoid logoGisgraphoid Gisgraphoid is a library to do geocoding on your Android mobile phone or tablet with the same Geocoder API as Google but with Gisgraphy. Runs on all Android versions, free, no Google API needed by the device, no API key, no limit. You can display the result on OpenStreetMap or Google Maps (Google API key required)
leaflet logo Plugins
2 Leaflet plugins are availables to use the webservices directly on a map : Geocoding : It allows you to add a geocoding input with autocompletion on a leaflet map. It wraps the Gisgraphy js API.   Reverse geocoding : It reverse geocodes when you rightclick on the map. It is an example and you can personalize it.

Openstreetmap data extract by country

Gisgraphy wants to simplify access to the OpeStreetMap data. The model of the OpenStreetMap data is in XML or PBF and is not simple to manage. To simplify this, we have :
  • Extracted all the streets(76 million), cities (4.3 million cities / 216,000 shapes), Points of interest (7 million), and house numbers(34 million) for all 240 countries and put it in a CSV/TSV format.
  • Split the main PBF file for each country.
  • Extracted the shape of more than 160,000 cities and localities from Quatroshapes with their associated geonames Id

All those files are freely available on our download server.. In addition to the native OpenStreetMap data, some pre-calculated fields (length, middle point) are added...Read more

A little bit further...

  • Importers from geonames CSV files. Just give the country(ies) you wish to import and / or the placetypes, and Gisgraphy downloads the files and imports them with all the alternate names (optional) and syncs the database with a fulltext search engine
  • All OpenStreetMap data is processed in CSV format (view data)
  • Importers for OpenStreetMap data in CSV (view data)
  • Importers for Quattroshapes data in CSV (view data)
  • 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 insensitive, separator characters stripping, ..) via an Java API or a webservice
  • Find nearby 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 with statistics interface
  • Fully replicated / scalable / high performance / cached services
  • Search for ZIPcode name, IATA, ICAO
  • Internationalized (with support of Cryllic, 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
  • Platform / language independent
  • Provides all the countries flags in svg and png format
  • ...