API de consulta de código postal
Convierte un código postal en el lugar al que pertenece: pueblo o ciudad, región, país y una coordenada. Abarca los códigos ZIP, los postcodes del Reino Unido, los códigos postales de Canadá, los códigos PIN de la India, los 郵便番号 de Japón y sus equivalentes en 160 países. Es útil por sí sola para formularios de dirección y como forma rápida y barata de ubicar un registro cuando solo tienes un código postal.
Ejemplo
$ 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"Envía siempre country cuando lo sepas. Los códigos postales no son únicos entre países: 10001 está en Nueva York y en varios otros países. Sin país, obtienes resultados de todos los países donde existe el código, empezando por el más poblado.
El formato es flexible. Los espacios, guiones y mayúsculas se normalizan, así que sw1a1aa y SW1A 1AA son lo mismo.
{
"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
}
]
}Qué recibes
| Campo | Significado |
|---|---|
results | Una entrada por cada lugar que abarca el código. La mayoría de los códigos corresponden a un solo lugar; algunos códigos rurales abarcan varios pueblos y devuelven varias entradas. |
place | El nombre del pueblo, la ciudad o la localidad tal como lo usa la autoridad postal. |
region, region_code | Estado, provincia o condado y su código ISO 3166-2 cuando existe. |
lat, lon | El punto de la autoridad postal para el código cuando está publicado; si no, el centroide de las direcciones que tenemos para él. |
Dónde se usa
Formularios de dirección
Pide primero el código postal y rellena la ciudad y la región. Los usuarios escriben menos y cometen menos errores.
Zonas de entrega y precios
Decide qué almacén atiende a un cliente o qué tarifa de envío se aplica a partir de las coordenadas del código postal.
Mapear datos de encuestas
Los conjuntos de datos que solo registran un código postal se pueden mapear con precisión de código postal, que a menudo es todo lo que la privacidad permite de todos modos.
Precio y límites
Una llamada, una solicitud, sin importar cuántos lugares abarque el código. Cada clave tiene 2.500 solicitudes gratuitas al día; a partir de ahí, 0,0001 € cada una del crédito prepago, o nada con una clave Unlimited (50 € al mes). Precios. Para una dirección completa con número de portal, usa la geocodificación directa.