Remplacement compatible d'OpenStreetMap Nominatim

L'instance publique de Nominatim demande au maximum une requête par seconde et aucune utilisation intensive. osm.mygeocode.com parle la même interface search et reverse, aux formats JSON, JSONv2 et GeoJSON, avec un quota sur lequel vous pouvez réellement vous appuyer pour planifier.

Changez un seul nom d'hôte

Hôte d'origine	`nominatim.openstreetmap.org`
À utiliser à la place	`osm.mygeocode.com`
Paramètre de clé	Aucune sur l'original, et aucune n'est nécessaire ici non plus : toute adresse dispose de 2 500 requêtes par jour sans clé. Pour le crédit, les forfaits et un historique d'utilisation, ajoutez `key=...` à la requête ou envoyez l'en-tête `X-API-Key`.

Avant

curl "https://nominatim.openstreetmap.org/search?q=Brandenburg+Gate+Berlin&format=json&addressdetails=1"

Après

curl "https://osm.mygeocode.com/search?q=Brandenburg+Gate+Berlin&format=json&addressdetails=1"

Pourquoi changer

Le serveur public de Nominatim est une ressource partagée soumise à une politique d'utilisation stricte. Faire tourner le vôtre est un travail à plein temps. Voici la même interface, sans aucun de ces deux problèmes.

Le même quota gratuit, avec ou sans clé. Les requêtes vers osm.mygeocode.com sont décomptées des mêmes 2 500 requêtes gratuites par jour dont votre adresse, ou votre clé, dispose sur nos propres endpoints. Au-delà, crédit prépayé à 0,0001 € par requête, ou 50 € par mois pour une clé Unlimited. L'inscription ne demande qu'une adresse e-mail, rien d'autre.

Voir les tarifs Obtenir une clé gratuite

Endpoints

Chemin sur osm.mygeocode.com	Rôle	Fourni par
`/search?q=...&format=json`	Recherche en texte libre	Géocodage direct
`/search?street=...&city=...&country=...&format=json`	Recherche structurée	Géocodage direct
`/reverse?lat=...&lon=...&format=json`	Inverse	Géocodage inverse

Exemple de réponse

Voici ce que renvoie la requête ci-dessus. Les noms de champs, l'imbrication et les types suivent Nominatim (OSM). Seules les données qu'ils contiennent sont les nôtres.

Réponse de osm.mygeocode.com

[
  {
    "place_id": 2384719,
    "licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
    "osm_type": "way",
    "osm_id": 518071791,
    "lat": "52.5162746",
    "lon": "13.3777041",
    "class": "tourism",
    "type": "attraction",
    "place_rank": 30,
    "importance": 0.8317,
    "addresstype": "tourism",
    "name": "Brandenburger Tor",
    "display_name": "Brandenburger Tor, Pariser Platz, Mitte, Berlin, 10117, Deutschland",
    "address": {
      "tourism": "Brandenburger Tor",
      "road": "Pariser Platz",
      "suburb": "Mitte",
      "borough": "Mitte",
      "city": "Berlin",
      "state": "Berlin",
      "postcode": "10117",
      "country": "Deutschland",
      "country_code": "de"
    },
    "boundingbox": ["52.5161073", "52.5164414", "13.3775375", "13.3778623"]
  }
]

Détails et différences

Nominatim n'a pas de clé, et aucune n'est nécessaire ici non plus pour les 2 500 premières requêtes de la journée. Pour le crédit, les forfaits et un historique d'utilisation, ajoutez key=... à la requête ou envoyez l'en-tête X-API-Key.

Les mentions de copyright, noms de licence, conditions et liens de confidentialité de la réponse sont les nôtres et non ceux du fournisseur d'origine. Tout le reste conserve la structure d'origine.

/search répond en jsonv2 par défaut et /reverse en XML, conformément aux valeurs par défaut de Nominatim.
Les formats xml, json, jsonv2, geojson et geocodejson sont tous servis.
La ligne de licence et l'attribut d'attribution XML sont les nôtres.
Pas d'endpoint par lots, car l'original n'en a pas. Pour les traitements en masse, utilisez POST /v1/forward ou /v1/reverse sur api.mygeocode.com (jusqu'à 100 par appel, une requête chacun).

Si votre client dépend d'un champ ou d'un comportement qui ne figure pas ici, dites-le-nous. Les écarts de compatibilité sont corrigés rapidement, car ils sont généralement minimes.

Autres hôtes compatibles

Fonctionnement des hôtes compatibles, la vue d'ensemble et les remplacements compatibles pour bibliothèques JavaScript.