Remplacement compatible de LocationIQ

Les endpoints search, reverse, autocomplete et timezone de LocationIQ répondent sur locationiq.mygeocode.com. Le tableau JSON de style Nominatim, avec display_name, address et boundingbox, est renvoyé avec une structure inchangée.

Changez un seul nom d'hôte

Hôte d'origine	`us1.locationiq.com` `eu1.locationiq.com`
À utiliser à la place	`locationiq.mygeocode.com`
Paramètre de clé	`key` (facultatif : toute adresse dispose de 2 500 requêtes par jour sans clé ; mettez ici votre clé My Geocode pour le crédit, les forfaits et un historique d'utilisation)

Avant

curl "https://us1.locationiq.com/v1/search?key=YOUR_LOCATIONIQ_KEY&q=Sydney+Opera+House&format=json"

Après

curl "https://locationiq.mygeocode.com/v1/search?key=YOUR_MYGEOCODE_KEY&q=Sydney+Opera+House&format=json"

Pourquoi changer

La même interface, 2 500 requêtes gratuites par jour et par clé, et une clé Unlimited forfaitaire pour les applications très sollicitées.

Le même quota gratuit, avec ou sans clé. Les requêtes vers locationiq.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 locationiq.mygeocode.com	Rôle	Fourni par
`/v1/search?q=...&format=json`	Géocodage direct	Géocodage direct
`/v1/reverse?lat=...&lon=...&format=json`	Géocodage inverse	Géocodage inverse
`/v1/autocomplete?q=...`	Saisie semi-automatique	Saisie semi-automatique d'adresses
`/v1/timezone?lat=...&lon=...`	Fuseau horaire	Recherche de fuseau horaire

Exemple de réponse

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

Réponse de locationiq.mygeocode.com

[
  {
    "place_id": "mg.au.poi.3b7e91c0",
    "licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
    "osm_type": "way",
    "osm_id": 4245932,
    "boundingbox": ["-33.8576", "-33.8560", "151.2141", "151.2166"],
    "lat": "-33.8567844",
    "lon": "151.2152967",
    "display_name": "Sydney Opera House, Bennelong Point, Sydney, New South Wales, 2000, Australia",
    "class": "tourism",
    "type": "attraction",
    "importance": 0.8543,
    "icon": "https://www.mygeocode.com/assets/img/icons/tourism.png",
    "address": {
      "name": "Sydney Opera House",
      "road": "Bennelong Point",
      "suburb": "Sydney",
      "city": "Sydney",
      "state": "New South Wales",
      "postcode": "2000",
      "country": "Australia",
      "country_code": "au"
    }
  }
]

Détails et différences

Aucune clé n'est nécessaire pour les 2 500 premières requêtes de la journée. Pour utiliser une clé My Geocode, placez-la là où se trouvait votre clé LocationIQ : le paramètre de requête key. L'en-tête X-API-Key, Authorization: Bearer et l'authentification HTTP Basic (la clé comme nom d'utilisateur) fonctionnent aussi sur tous les hôtes, de sorte que les bibliothèques clientes qui s'authentifient à leur manière continuent de fonctionner sans modification.

L'endpoint de fuseau horaire est en service et renvoie le nom, le décalage, l'indicateur d'heure d'été et les deux noms.
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.