Remplacement compatible de HERE Geocoding and Search

HERE répartit son API de recherche sur plusieurs hôtes. Tous sont regroupés sur here.mygeocode.com, qui répond avec le même tableau items, le même objet address et le même objet position que lisent les clients HERE.

Changez un seul nom d'hôte

Hôte d'origine	`geocode.search.hereapi.com` `revgeocode.search.hereapi.com` `autosuggest.search.hereapi.com` `autocomplete.search.hereapi.com`
À utiliser à la place	`here.mygeocode.com`
Paramètre de clé	`apiKey` (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://geocode.search.hereapi.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_HERE_KEY"

Après

curl "https://here.mygeocode.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_MYGEOCODE_KEY"

Pourquoi changer

HERE facture à la transaction avec des engagements mensuels. Un simple changement de nom d'hôte vous fait passer à 2 500 appels gratuits par jour et par adresse, avec ou sans clé, puis à une tarification forfaitaire ou à la requête.

Le même quota gratuit, avec ou sans clé. Les requêtes vers here.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 here.mygeocode.com	Rôle	Fourni par
`/v1/geocode?q=...`	Géocodage	Géocodage direct
`/v1/geocode?qq=street=...;city=...`	Géocodage avec requête qualifiée	Géocodage direct
`/v1/revgeocode?at=lat,lng`	Géocodage inverse	Géocodage inverse
`/v1/autosuggest?q=...&at=lat,lng`	Autosuggest	Saisie semi-automatique d'adresses
`/v1/autocomplete?q=...`	Saisie semi-automatique	Saisie semi-automatique d'adresses

Exemple de réponse

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

Réponse de here.mygeocode.com

{
  "items": [
    {
      "title": "Invalidenstraße 116, 10115 Berlin, Deutschland",
      "id": "mg.de.addr.9a3f1c77",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Invalidenstraße 116, 10115 Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "district": "Mitte",
        "street": "Invalidenstraße",
        "postalCode": "10115",
        "houseNumber": "116"
      },
      "position": { "lat": 52.53041, "lng": 13.38527 },
      "access": [ { "lat": 52.53039, "lng": 13.38533 } ],
      "mapView": { "west": 13.38393, "south": 52.52951, "east": 13.38661, "north": 52.53131 },
      "scoring": {
        "queryScore": 1.0,
        "fieldScore": { "city": 1.0, "streets": [1.0], "houseNumber": 1.0, "postalCode": 1.0 }
      }
    }
  ]
}

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é HERE : le paramètre de requête apiKey (apikey est aussi accepté), ou un jeton Bearer. 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.

Les erreurs utilisent les champs title, status, code, cause et action de HERE, avec un identifiant de corrélation.
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.