API de code postal

Transformez un code postal en lieu auquel il appartient : ville ou localité, région, pays et coordonnée. Couvre les ZIP codes américains, les postcodes britanniques, les codes postaux canadiens, les codes PIN indiens, les 郵便番号 japonais et leurs équivalents dans 160 pays. Utile en soi pour les formulaires d'adresse, et comme moyen rapide et économique de localiser un enregistrement quand vous n'avez qu'un code postal.

GEThttps://api.mygeocode.com/v1/postcode?code=...&country=...

Essayer dans la démo Référence complète

Exemple

Requête

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=10001&country=us"

# UK postcodes resolve to a street or a handful of buildings
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=SW1A+1AA&country=gb"

Envoyez toujours country quand vous le connaissez. Les codes postaux ne sont pas uniques d'un pays à l'autre : 10001 se trouve à New York et dans plusieurs autres pays. Sans pays, vous obtenez des résultats de tous les pays où le code existe, les plus peuplés en premier.

Le format est tolérant. Les espaces, les tirets et la casse sont normalisés, donc sw1a1aa et SW1A 1AA sont identiques.

Réponse

{
  "status": "ok",
  "postcode": "10001",
  "country_code": "US",
  "results": [
    {
      "postcode": "10001",
      "place": "New York",
      "region": "New York",
      "region_code": "NY",
      "country": "United States",
      "country_code": "US",
      "lat": 40.7484,
      "lon": -73.9967
    }
  ]
}

Ce que vous recevez

Champ	Signification
`results`	Une entrée par lieu couvert par le code. La plupart des codes correspondent à un seul lieu ; certains codes ruraux couvrent plusieurs villages et renvoient plusieurs entrées.
`place`	Le nom de la ville ou de la localité tel que l'utilise l'autorité postale.
`region`, `region_code`	État, province ou comté, et son code ISO 3166-2 s'il en existe un.
`lat`, `lon`	Le point de l'autorité postale pour le code lorsqu'il est publié, sinon le centroïde des adresses dont nous disposons pour ce code.

Où elle est utilisée

Formulaires d'adresse

Demandez d'abord le code postal et remplissez la ville et la région. Les utilisateurs saisissent moins et font moins d'erreurs.

Zones de livraison et tarification

Déterminez quel dépôt dessert un client ou quelle tranche d'expédition s'applique à partir des coordonnées du code postal.

Cartographier des données d'enquête

Les jeux de données qui n'enregistrent qu'un code postal peuvent être cartographiés à la précision du code postal, ce qui est souvent tout ce que la confidentialité permet de toute façon.

Prix et limites

Un appel, une requête, quel que soit le nombre de lieux couverts par le code. Chaque clé dispose de 2 500 requêtes gratuites par jour ; au-delà, 0,0001 € par requête sur le crédit prépayé, ou rien avec une clé Unlimited (50 € par mois). Tarifs. Pour une adresse complète avec numéro de rue, utilisez plutôt le géocodage direct.