Часто задаваемые вопросы
Краткие ответы на вопросы, которые нам задают чаще всего. Если вашего вопроса здесь нет, задайте его.
Начало работы
Нужен ли API-ключ или аккаунт, чтобы попробовать?
Нет. Любой адрес получает 2 500 запросов в день без ключа и без аккаунта на каждом эндпоинте и каждом совместимом хосте. Зарегистрируйтесь (имя, адрес электронной почты и пароль), когда вам понадобятся собственные ключи, история использования, предоплаченный баланс или пакет Unlimited. Запросы без ключа и запросы с ключом из одной и той же сети делят одну дневную квоту, поэтому аккаунт не удваивает бесплатные 2 500.
Что нужно для регистрации?
Ваше имя, адрес электронной почты и пароль. Больше ничего: ни компании, ни карты. Вы сразу можете создать дополнительные ключи, а пополнить баланс или купить пакет тогда, когда решите.
Как работает баланс?
Вы заранее пополняете баланс на любую сумму от 5 € картой или криптовалютой. Каждый запрос сверх бесплатных 2 500 ключа за день списывает с него 0,0001 €. Баланс общий для всех ваших ключей с оплатой по мере использования, никогда не сгорает, и ничего не списывается автоматически. Когда баланс пуст, запросы сверх бесплатной квоты отклоняются с кодом 402, пока вы его не пополните.
Как принимается оплата?
Картой через Polar или криптовалютой через NOWPayments: Bitcoin, Ethereum, USDT, USDC, Litecoin и многие другие. Сумма фиксируется при оформлении и зачисляется после подтверждения платежа. Все цены указаны в евро.
Что входит в пакет Unlimited?
Ключ без оплаты за запросы на каждом эндпоинте и каждом совместимом хосте за 50 € в месяц, который можно использовать максимум с трёх IP-адресов за скользящие 24 часа. У каждого пакета свой ключ; закажите несколько, если у вас несколько приложений. См. цены.
Есть ли реферальная программа?
Да. В личном кабинете есть реферальная ссылка; 10 % от каждого счёта, оплаченного тем, кто зарегистрировался по ней, поступает на реферальный баланс, который хранится отдельно от основного баланса. Переводите его на основной баланс когда угодно или выводите в криптовалюте от 20 €. Вывод средств обрабатывается вручную, а идентификатор транзакции появляется в личном кабинете.
Есть ли у вас купоны?
Иногда: процентные или фиксированные скидки на пополнение или пакет либо бонусный баланс. Введите код при создании счёта или в любом неоплаченном счёте перед оплатой.
Доступ и ограничения
Как считается бесплатная квота?
На ключ, за сутки UTC, суммарно по всем эндпоинтам и совместимым хостам. Пакетные запросы IP и многоточечные вызовы высот засчитываются по одному за каждый элемент. Отклонённые запросы и ошибки сервера никогда не засчитываются.
Что означает ограничение по IP?
Первые адреса, использующие ключ, занимают по слоту на 24 часа с момента своего первого запроса. У ключа с оплатой по мере использования два слота, у ключа Unlimited три. Когда 24 часа слота истекают, он освобождается сам, поэтому если два сервера использовали ключ в 02:00, а третий в 04:00, то два слота снова свободны в 02:00 следующего дня, а третий в 04:00. Запрос с нового адреса, когда все слоты заняты, отклоняется с HTTP 403 и кодом key_ip_limit; в ответе указано, когда освободится следующий слот. Для большего числа машин создайте больше ключей или добавьте пакеты.
Можно ли вызывать API из браузера или мобильного приложения?
CORS включён, но ключ в клиентском коде виден всем и упрётся в ограничение по IP после пары посетителей. Вызывайте API со своего сервера и храните ключ там. То же касается совместимых JavaScript-библиотек карт: для тайлов и загрузки библиотек ключ не нужен, а вызовы геокодирования должны идти через ваш сервер.
Есть ли лимит запросов помимо дневной квоты?
Фиксированного сейчас нет. Трафик, похожий на зациклившийся скрипт или атаку, может замедляться, и мы сообщим вам, если это когда-нибудь произойдёт с одним из ваших ключей. Пакетные эндпоинты существуют для того, чтобы вам не требовались сотни запросов в секунду.
Что будет, если мой ключ утечёт?
Отзовите его в личном кабинете и создайте новый. Из-за ограничения по IP утёкший ключ в любом случае нельзя использовать больше чем с двух или трёх машин в сутки, а поскольку баланс предоплачен, никто не сможет накрутить счёт сверх суммы, которую вы решили внести.
Данные и точность
Что означает поле precision?
Оно показывает, что обозначает возвращённая точка: house означает здание или участок, street означает позицию, интерполированную вдоль улицы, postcode означает центр зоны почтового индекса, а admin означает центр города, района, региона или страны. Если вы запрашивали дом, а получили postcode, значит, мы не смогли найти дом.
В каких странах есть данные на уровне домов?
На странице покрытия указан лучший доступный уровень для каждой из 249 стран и территорий, с фильтрами по региону и уровню. Она обновляется с каждым выпуском данных.
Какие источники данных вы используете?
Официальные адресные и почтовые данные, регистрационные и маршрутизационные данные интернета для определения IP, стандартную базу часовых поясов и глобальные модели рельефа, а также наши собственные исправления. Каждый источник перед добавлением проверяется по остальным, и ничего не собирается с других сервисов геокодирования.
Можно ли хранить или кешировать результаты?
Да. Результаты остаются вашими: храните их в своей базе данных, кешируйте и показывайте на любой карте, в том числе на картах других провайдеров. Единственное ограничение в условиях касается перепродажи необработанных данных в виде собственного сервиса геокодирования.
Как часто обновляются данные?
Адресные данные обновляются ежемесячно, данные IP еженедельно, правила часовых поясов всякий раз, когда IANA публикует релиз, а данные о высотах, когда появляется более качественная открытая модель.
Поддерживаете ли вы языки, кроме английского?
Передайте lang с кодом ISO 639-1, и названия мест вернутся на этом языке, если они у нас есть, а иначе будет использовано местное название. Адреса форматируются по правилам страны, в которой находится адрес.
Совместимость
Являются ли совместимые хосты точными копиями исходных API?
Пути, параметры и формат ответов соответствуют публичной документации каждого провайдера, поэтому существующий клиентский код разбирает ответы без изменений. Данные наши, поэтому значения отличаются, а несколько функций, специфичных для провайдера, не поддерживаются. На каждой странице совместимости перечислены отличия.
Показывает ли совместимая замена Google Maps JavaScript тайлы карт Google?
Нет. Загрузчик на gapi.mygeocode.com предоставляет пространство имён google.maps, за которым работают наши собственные тайлы карт, геокодер, автодополнение и сервис высот. Street View, Directions и Places Details не поддерживаются. Загрузки карты не засчитываются в вашу квоту. См. совместимые JavaScript-библиотеки.
Связан ли My Geocode с Google, Microsoft, HERE или Mapbox?
Нет. Эти названия принадлежат их владельцам и используются здесь только для того, чтобы указать, в каких форматах мы можем отвечать.
Поддержка
Есть ли гарантия доступности?
Тарифы с самостоятельным подключением не включают договорной SLA. Мы запускаем API более чем в одном регионе и показываем текущее состояние на status.mygeocode.com. Если вам нужен письменный SLA, свяжитесь с нами.
Как получить поддержку?
Напишите на support@mygeocode.com. Платные аккаунты получают ответ в течение одного рабочего дня. На вопросы с бесплатных ключей мы тоже отвечаем, по мере возможности.