My Geocode

API поиска почтовых индексов

Узнайте по почтовому индексу, к какому месту он относится: город или посёлок, регион, страна и координата. Поддерживаются ZIP-коды США, почтовые индексы Великобритании и Канады, индийские PIN-коды, японские 郵便番号 и их аналоги в 160 странах. Полезно само по себе для адресных форм, а также как быстрый и дешёвый способ определить местоположение записи, когда у вас есть только почтовый индекс.

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

Попробовать в демо Полный справочник

Пример

Запрос
$ 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"

Всегда передавайте country, если знаете страну. Почтовые индексы не уникальны между странами: 10001 есть и в Нью-Йорке, и в ряде других стран. Без страны вы получите результаты из всех стран, где существует этот индекс, начиная с самой населённой.

Формат ввода не важен. Пробелы, дефисы и регистр нормализуются, поэтому sw1a1aa и SW1A 1AA равнозначны.

Ответ
{
  "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
    }
  ]
}

Что вы получаете

ПолеЗначение
resultsОдна запись на каждое место, которое охватывает индекс. Большинство индексов соответствуют одному месту; некоторые сельские индексы охватывают несколько деревень и возвращают несколько записей.
placeНазвание города, посёлка или населённого пункта в том виде, в каком его использует почтовая служба.
region, region_codeШтат, провинция или графство и его код ISO 3166-2, если он существует.
lat, lonТочка почтовой службы для индекса, если она опубликована, иначе центр адресов, которые у нас есть для этого индекса.

Где это используется

Адресные формы

Сначала запросите почтовый индекс и заполните город и регион. Пользователи вводят меньше и реже ошибаются.

Зоны доставки и тарифы

Определяйте по координатам почтового индекса, какой склад обслуживает клиента или какой тариф доставки применяется.

Картографирование данных опросов

Наборы данных, в которых записан только почтовый индекс, можно нанести на карту с точностью до индекса, а большего конфиденциальность зачастую и не позволяет.

Цена и лимиты

Один вызов, один запрос, сколько бы мест ни охватывал индекс. У каждого ключа есть 2 500 бесплатных запросов в день; сверх этого 0,0001 € за запрос с предоплаченного баланса или бесплатно на ключе Unlimited (50 € в месяц). Цены. Для полного адреса с номером дома используйте прямое геокодирование.