Remplacement compatible de Geocodio

Geocodio se concentre sur les États-Unis et le Canada. geocodio.mygeocode.com répond à ses endpoints geocode et reverse avec la même structure, et accepte des adresses du monde entier.

Changez un seul nom d'hôte

Hôte d'origine	`api.geocod.io`
À utiliser à la place	`geocodio.mygeocode.com`
Paramètre de clé	`api_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://api.geocod.io/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_GEOCODIO_KEY"

Après

curl "https://geocodio.mygeocode.com/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_MYGEOCODE_KEY"

Pourquoi changer

La même interface, une couverture mondiale et aucun palier de prix par recherche à surveiller.

Le même quota gratuit, avec ou sans clé. Les requêtes vers geocodio.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 geocodio.mygeocode.com	Rôle	Fourni par
`/v1.7/geocode?q=...`	Géocodage direct	Géocodage direct
`/v1.7/reverse?q=lat,lng`	Géocodage inverse	Géocodage inverse
`/v1.7/geocode (POST, JSON array)`	Géocodage direct par lots	Géocodage direct

Exemple de réponse

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

Réponse de geocodio.mygeocode.com

{
  "input": {
    "address_components": {
      "number": "1109",
      "predirectional": "N",
      "street": "Highland",
      "suffix": "St",
      "formatted_street": "N Highland St",
      "city": "Arlington",
      "state": "VA",
      "country": "US"
    },
    "formatted_address": "1109 N Highland St, Arlington, VA"
  },
  "results": [
    {
      "address_components": {
        "number": "1109",
        "predirectional": "N",
        "street": "Highland",
        "suffix": "St",
        "formatted_street": "N Highland St",
        "city": "Arlington",
        "county": "Arlington County",
        "state": "VA",
        "zip": "22201",
        "country": "US"
      },
      "formatted_address": "1109 N Highland St, Arlington, VA 22201",
      "location": { "lat": 38.886665, "lng": -77.094733 },
      "accuracy": 1,
      "accuracy_type": "rooftop",
      "source": "My Geocode"
    }
  ]
}

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é Geocodio : le paramètre de requête api_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.

Les requêtes par lots fonctionnent : envoyez une liste JSON ou un objet. La réponse est results, avec une entrée par élément envoyé, chacune portant la query dont elle provient (la clé de l'objet si vous avez envoyé un objet) et sa propre response.
Les lots inverses ont la même structure, avec des chaînes lat,lon en entrée.
Un lot accepte jusqu'à 10 000 entrées, comme chez Geocodio, et chaque entrée compte pour une recherche, comme Geocodio les compte. Un lot plus grand que ce qui reste du quota de la journée est refusé en entier avec l'erreur de Geocodio plutôt que traité partiellement.

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.