API
Восемь эндпоинтов под https://api.mygeocode.com/v1/. Каждый принимает параметры запроса в GET-запросе и возвращает JSON. У них общая квота, общий набор кодов ошибок и одна цена.
API прямого геокодирования
Эндпоинт GET /v1/forwardОтправьте адрес, название места или примерное описание и получите координаты, очищенный адрес и каждую его часть.
Подробности и примерыAPI обратного геокодирования
Эндпоинт GET /v1/reverseОтправьте широту и долготу и получите ближайший адрес с отдельно выделенными городом, регионом, почтовым индексом и страной.
Подробности и примерыAPI автодополнения адресов
Эндпоинт GET /v1/autocompleteПодсказывайте адреса, пока пользователь печатает. Каждая подсказка приходит с координатами, так что второй вызов нужен редко.
Подробности и примерыAPI определения IPv4
Эндпоинт GET /v1/ipv4Страна, регион, город, координаты, часовой пояс и владелец сети для любого IPv4-адреса или для вызывающей стороны, если адрес не указан.
Подробности и примерыAPI определения IPv6
Эндпоинт GET /v1/ipv6Те же сведения для IPv6-адресов, а также анонсированный префикс, к которому относится адрес.
Подробности и примерыAPI определения часового пояса
Эндпоинт GET /v1/timezoneНазвание часового пояса IANA, смещение от UTC, статус летнего времени и местное время для любой координаты, сейчас или на выбранную вами метку времени.
Подробности и примерыAPI определения высоты
Эндпоинт GET /v1/elevationВысота над уровнем моря в метрах для одной точки или до 100 точек за один вызов.
Подробности и примерыAPI поиска почтовых индексов
Эндпоинт GET /v1/postcodeПревращайте почтовый индекс в название места, регион и координаты. Работает с ZIP-кодами, почтовыми индексами и их аналогами в большинстве стран.
Подробности и примерыЧто у них общего
Одна оболочка
В каждом ответе есть поле верхнего уровня status со значением ok или error. Ошибки содержат машиночитаемый code и фразу, которую можно записать в лог. Координаты всегда указываются в десятичных градусах в lat и lon.
Одинаковые правила везде
Любой адрес получает 2 500 бесплатных запросов в день без ключа. У каждого ключа свои 2 500 бесплатных запросов в день (общие с запросами без ключа из той же сети), затем предоплаченный баланс или пакет Unlimited. Ключ с оплатой по мере использования обслуживает два IP-адреса в скользящем окне 24 ч, ключ Unlimited три. См. аутентификацию.
Одна цена
Обратное геокодирование стоит столько же, сколько определение IP: ничего за первые 2 500 в день на каждом ключе, затем 0,0001 € за каждый с предоплаченного баланса или 50 € в месяц за ключ Unlimited. См. цены.
Что считается одним запросом
Почти всегда один вызов равен одному запросу. Исключение составляют пакетные вызовы, где каждый элемент пакета учитывается отдельно.
| Эндпоинт | Учитывается как |
|---|---|
| Прямое геокодирование, обратное геокодирование, поиск почтовых индексов | 1 запрос за вызов, независимо от того, сколько результатов вернулось |
| Автодополнение адресов | 1 запрос за вызов. Используйте debounce для нажатий клавиш в клиенте; SDK будут делать это за вас |
| Определение IPv4 и IPv6 | 1 запрос за вызов или 1 за каждый адрес в пакете |
| Определение часового пояса | 1 запрос за вызов |
| Определение высоты | 1 запрос за точку. Вызов с 20 точками учитывается как 20 |
| Совместимые хосты (Google, Bing, HERE и другие) | Те же правила, что и у эндпоинта, на котором они основаны |
| Совместимые JavaScript-библиотеки: загрузки карт и тайлы | 0. Учитываются только вызовы геокодера, автодополнения и высоты |
Пока нет
Маршрутизация, матрицы расстояний и изохроны не входят в сервис и не запланированы на этот год. Поиск точек интереса по категориям рассматривается. Если вам для перехода нужно что-то из этого, сообщите нам; это помогает решить, что делать дальше.