Remplacement compatible de PositionStack

Les endpoints de géocodage direct et inverse de PositionStack répondent sur positionstack.mygeocode.com avec le même tableau data et les mêmes noms de champs à plat. Le HTTPS est disponible ici sur toutes les offres, y compris l'offre gratuite.

Changez un seul nom d'hôte

Hôte d'origine	`api.positionstack.com`
À utiliser à la place	`positionstack.mygeocode.com`
Paramètre de clé	`access_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 "http://api.positionstack.com/v1/forward?access_key=YOUR_POSITIONSTACK_KEY&query=350+5th+Avenue+New+York"

Après

curl "https://positionstack.mygeocode.com/v1/forward?access_key=YOUR_MYGEOCODE_KEY&query=350+5th+Avenue+New+York"

Pourquoi changer

L'offre gratuite de PositionStack fonctionne uniquement en HTTP et est plafonnée chaque mois. Ici, tout passe en HTTPS et le quota gratuit de chaque clé se réinitialise chaque jour.

Le même quota gratuit, avec ou sans clé. Les requêtes vers positionstack.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 positionstack.mygeocode.com	Rôle	Fourni par
`/v1/forward?query=...`	Géocodage direct	Géocodage direct
`/v1/reverse?query=lat,lng`	Géocodage 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 PositionStack. Seules les données qu'ils contiennent sont les nôtres.

Réponse de positionstack.mygeocode.com

{
  "data": [
    {
      "latitude": 40.748428,
      "longitude": -73.985654,
      "type": "address",
      "name": "350 5th Avenue",
      "number": "350",
      "postal_code": "10118",
      "street": "5th Avenue",
      "confidence": 1,
      "region": "New York",
      "region_code": "NY",
      "county": "New York County",
      "locality": "New York",
      "administrative_area": null,
      "neighbourhood": "Midtown",
      "country": "United States",
      "country_code": "USA",
      "continent": "North America",
      "label": "350 5th Avenue, New York, NY, USA"
    }
  ]
}

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

Le géocodage direct et inverse renvoient tous deux la structure de tableau data.
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.