API de consulta de código postal

Transforme um código postal no lugar ao qual ele pertence: vila ou cidade, região, país e uma coordenada. Abrange ZIP codes dos EUA, postcodes do Reino Unido, códigos postais canadenses, PIN codes da Índia, 郵便番号 japoneses e seus equivalentes em 160 países. Útil por si só em formulários de endereço e como uma forma rápida e barata de localizar um registro quando tudo o que você tem é um código postal.

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

Experimente na demonstração Referência completa

Exemplo

Requisição

$ 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"

Sempre envie country quando souber. Códigos postais não são únicos entre países: 10001 fica em Nova York e em vários outros países. Sem um país, você recebe resultados de todos os países onde o código existe, do mais populoso para o menos.

A formatação é tolerante. Espaços, hifens e maiúsculas e minúsculas são normalizados, então sw1a1aa e SW1A 1AA são a mesma coisa.

Resposta

{
  "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
    }
  ]
}

O que você recebe

Campo	Significado
`results`	Uma entrada por lugar que o código abrange. A maioria dos códigos corresponde a um lugar; alguns códigos rurais abrangem vários povoados e retornam várias entradas.
`place`	O nome da vila, cidade ou localidade tal como a autoridade postal o usa.
`region`, `region_code`	Estado, província ou condado e seu código ISO 3166-2 quando existir.
`lat`, `lon`	O ponto da autoridade postal para o código, quando publicado; caso contrário, o centroide dos endereços que temos para ele.

Onde é usada

Formulários de endereço

Peça primeiro o código postal e preencha a cidade e a região. Os usuários digitam menos e erram menos.

Áreas de entrega e preços

Decida qual centro de distribuição atende um cliente ou qual faixa de frete se aplica a partir das coordenadas do código postal.

Mapear dados de pesquisas

Conjuntos de dados que registram só um código postal podem ser mapeados com precisão de código postal, que muitas vezes é tudo o que a privacidade permite de qualquer forma.

Preço e limites

Uma chamada, uma requisição, não importa quantos lugares o código abranja. Toda chave tem 2.500 requisições gratuitas por dia; acima disso, € 0,0001 cada uma a partir do crédito pré-pago, ou nada em uma chave Unlimited (€ 50 por mês). Preços. Para um endereço completo com número, use a geocodificação direta.