Skip to content

GEOCODER

Geocoder est un service web standard permettant de faire du géocodage à partir de différentes sources de données géolocalisées.

Note

Le service Geocoder repose sur la solution Geokoder

Jeux de données accessibles

NominatimBase Addresse NationaleBDXéoEURDEPTélérayICOSRTERadomeSemenceMETARHydrométrie Hub'EauAdmin ExpressGADM

Utilisation

Le service geocoder supporte différentes requêtes exposées ci-après.

/capabilities/:operation

Le point d'entrée capabilities permet de consulter la liste des sources de géocodage disponibles dans le service en fonction de l'opération souhaitée.

  • Géocodage direct
HTTP - GET
https://api.planet._DOMAIN_/geocoder/capabilities/forward?jwt=_TOKEN_
  • Géocodage inverse
HTTP - GET
https://api.planet._DOMAIN_/geocoder/capabilities/reverse?jwt=_TOKEN_

/forward

L'opération forward permet de réaliser une opération de géocodage directe qui va rechercher les entités correspondantes à un nom complet ou partiel. Cette opération s'effectue par défaut parmis toutes les sources de géocodage proposées par le service. Il est cependant possible de limiter les sources utilisées pour l'opération via le paramètre sources de la requête.

  • Géocodage parmis toutes les sources disponibles:
HTTP - GET
https://api.planet._DOMAIN_/geocoder/forward?jwt=_TOKEN_&q=blaye
HTTP - GET
https://api.planet._DOMAIN_/geocoder/forward?jwt=_TOKEN_&q=blaye&sources=opendatafrance

/reverse

L'opération reverse permet de réaliser une opération de géocodage inverse qui va rechercher les entités polygonales contenant une position donnée ou les entités situées à une certaine distance d'une position donnée. Cette opération s'effectue par défaut parmis toutes les sources de géocodage proposées par le service. Il est cependant possible de limiter les sources utilisées pour l'opération via le paramètre sources de la requête.

  • Géocodage inverse parmis toutes les sources disponibles:
HTTP - GET
https://api.planet._DOMAIN_/geocoder/reverse?jwt=_TOKEN_&lat=48.7945965&lon=2.2719145
  • Géocodage inverse limité à la source World seas:
HTTP - GET
https://api.planet._DOMAIN_/geocoder/reverse?jwt=_TOKEN_&lat=49.80077&lon=-2.59277&sources=world-seas*
  • Géocodage inverse limité à la source Admin Express avec distance maximale de 10km:
HTTP - GET
https://api.planet._DOMAIN_/geocoder/reverse?jwt=_TOKEN_&lat=48.7945965&lon=2.2719145&distance=10000&sources=admin-express*
  • Géocodage inverse limité à la source Admin Express sur Mayotte (DROM):
HTTP - GET
https://api.planet._DOMAIN_/geocoder/reverse?jwt=_TOKEN_&lat=-12.782483&lon=45.1989941&sources=admin-express*
  • Géocodage inverse limité à la source Admin Express sur la Polynésie française (COM):
HTTP - GET
https://api.planet._DOMAIN_/geocoder/reverse?jwt=_TOKEN_&lat=-17.55943&lon=-149.5615819&sources=admin-express*