Remplacement compatible de Geoapify

Les endpoints de géocodage de Geoapify renvoient des FeatureCollections GeoJSON avec un objet properties à plat. geoapify.mygeocode.com renvoie la même chose, y compris les blocs rank et datasource, ainsi que son endpoint d'informations IP.

Changez un seul nom d'hôte

Hôte d'origine
  • api.geoapify.com
À utiliser à la placegeoapify.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://api.geoapify.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_GEOAPIFY_KEY"
Après
curl "https://geoapify.mygeocode.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_MYGEOCODE_KEY"

Pourquoi changer

L'offre gratuite de Geoapify est de 3 000 crédits par jour, avec attribution obligatoire. Ici, c'est 2 500 requêtes par jour et par clé sans obligation d'attribution, et l'usage payant n'a pas de palier mensuel à dépasser.

Le même quota gratuit, avec ou sans clé. Les requêtes vers geoapify.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 geoapify.mygeocode.comRôleFourni par
/v1/geocode/search?text=...Géocodage directGéocodage direct
/v1/geocode/reverse?lat=...&lon=...Géocodage inverseGéocodage inverse
/v1/geocode/autocomplete?text=...Saisie semi-automatiqueSaisie semi-automatique d'adresses
/v1/ipinfo?ip=...Géolocalisation IPRecherche IPv4

Exemple de réponse

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

Réponse de geoapify.mygeocode.com
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "datasource": { "sourcename": "mygeocode", "attribution": "My Geocode", "license": "https://www.mygeocode.com/terms/" },
        "country": "Netherlands",
        "country_code": "nl",
        "state": "North Holland",
        "city": "Amsterdam",
        "postcode": "1012 JS",
        "street": "Dam",
        "housenumber": "1",
        "lon": 4.893604,
        "lat": 52.373119,
        "formatted": "Dam 1, 1012 JS Amsterdam, Netherlands",
        "address_line1": "Dam 1",
        "address_line2": "1012 JS Amsterdam, Netherlands",
        "result_type": "building",
        "rank": { "importance": 0.41, "confidence": 1, "confidence_city_level": 1, "confidence_street_level": 1, "match_type": "full_match" },
        "place_id": "mg.nl.addr.c21d40e8"
      },
      "geometry": { "type": "Point", "coordinates": [4.893604, 52.373119] },
      "bbox": [4.893004, 52.372719, 4.894204, 52.373519]
    }
  ],
  "query": {
    "text": "Dam 1 Amsterdam",
    "parsed": { "housenumber": "1", "street": "dam", "city": "amsterdam", "expected_type": "building" }
  }
}

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é Geoapify : le paramètre de requête apiKey. 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 réponses contiennent les champs que renvoie Geoapify et rien d'autre, de sorte qu'une réponse peut être intégrée à du code qui analyse déjà Geoapify. Nos données supplémentaires (altitude du sol, menaces et détails du réseau) sont disponibles sur demande : ajoutez mg_extras=1 à la requête ou envoyez X-MG-Extras: 1.

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.

  • L'endpoint IP renvoie la structure d'objet propre à Geoapify.
  • Le géocodage par lots fonctionne comme chez Geoapify : POST /v1/batch/geocode/search ou /reverse avec un tableau JSON de 1 000 éléments au maximum renvoie 202 avec un id de tâche et une url, et un GET sur cette URL renvoie une ligne par élément avec sa query. Chaque adresse compte pour une requête ; la récupération ne compte rien.

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.