Часто задаваемые вопросы о геокодировании

В этом разделе часто задаваемых вопросов рассматриваются вопросы, относящиеся к API геокодирования. Вопросы, общие для всех платформ Google Maps, можно найти в разделе часто задаваемых вопросов по платформе Google Maps. См. также Рекомендации по геокодированию адресов .

Поиск неисправностей

Поиск неисправностей

Я получаю больше запросов, которые возвращают ZERO_RESULTS с помощью геокодера. Что происходит?

В геокодере неоднозначные, неполные и плохо отформатированные запросы, такие как неправильно написанные или несуществующие адреса, склонны давать НУЛЕВЫЕ_РЕЗУЛЬТАТЫ. Если адрес не может быть найден, ZERO_RESULTS предпочтительнее частичного результата (например, вместо адреса возвращается только пригород).

Если ваше приложение занимается вводом адресов пользователем, функция Place Autocomplete в Places API может обеспечить более качественные результаты. Автозаполнение мест позволяет пользователям выбирать из набора результатов на основе того, что они набрали, что позволяет пользователям выбирать между результатами с одинаковыми именами и корректировать свой запрос, если они неправильно написали адрес.

Если у вас есть приложение, обрабатывающее неоднозначные или неполные запросы или запросы, которые могут содержать ошибки, мы рекомендуем вам использовать функцию автозаполнения мест в Places API, а не прямой геокодер, доступный в API геокодирования. Дополнительные сведения см . в разделах «Рекомендации по геокодированию адресов» и «Геокодирование адресов» в записи блога Google Maps API .

Мне нужны быстрые ответы, а геокодер слишком медленный для моего приложения. Что я могу использовать для более быстрого ответа?

Мы рекомендуем приложениям, которые реагируют на ввод пользователя и, следовательно, очень чувствительны к задержкам, использовать функцию автозаполнения мест в Places API (также доступную в JavaScript , Android или iOS ), а не адресное геокодирование. Автозаполнение мест оптимизировано для интерактивного использования и поэтому имеет очень низкую задержку.

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

Как уменьшить задержку в Directions API и Distance Matrix API?

Вместо адресов используйте идентификаторы мест , чтобы указать путевые точки, отправную точку и пункт назначения. Идентификаторы мест лучше всего получать с помощью функции автозаполнения мест в Places API или библиотеки Places в Maps JavaScript API. См. также информацию о параметре placeIdOnly , который можно использовать для снижения стоимости автозаполнения места.

Когда к API направлений или API матрицы расстояний запрашивается строка адреса, а не идентификатор места или широта, они используют тот же серверный интерфейс, что и API геокодирования, для преобразования этого адреса в идентификатор места перед расчетом направлений. Автозаполнение мест происходит быстрее, чем геокодирование адреса. Для приложений, которые используют API направлений или API матрицы расстояний в ситуациях с высокой задержкой, например, при ответе на ввод пользователя, мы рекомендуем использовать автозаполнение мест, чтобы получить идентификаторы мест, соответствующие этим адресам, и передать идентификаторы мест в API направлений. или API матрицы расстояний. Такой подход значительно снижает задержку. В нашей документации приведен пример использования автозаполнения мест с указаниями .

Как сообщить об ошибках в геокодере?

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

Геокодер не дает хороших результатов для моего варианта использования. Какая помощь доступна?

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

Как получить наилучшие результаты с помощью геокодера, используя фильтрацию компонентов?

В геокодере фильтрация компонентов применяет только ограничения postal_code и country . Следующие примеры иллюстрируют, как лучше всего использовать фильтрацию компонентов в зависимости от нужных вам результатов. В примерах URL-адресов запроса обязательно замените YOUR_API_KEY своим фактическим ключом API.

  • Чтобы ограничить почтовые индексы определенной страной, обязательно укажите ограничение страны, используя код страны ISO 3166-2 . Например: components=country:CH|postal_code:8000 возвращает «8000 Цюрих, Швейцария». 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Чтобы ограничить запросы определенной страной, обязательно укажите ограничение страны, используя код страны ISO 3166-2 . Названия стран и другие сокращения не гарантируют того же результата, что и коды стран.

    Примеры:

    • Геокодирование components=country:FRA|locality:gallus возвращает район Галлус во Франкфурте-на-Майне, Германия. Это связано с тем, что трехбуквенный код страны для Франции (FRA) не поддерживается, поэтому допускаются результаты в любой стране, а результат во Франкфурте подходит лучше, чем что-либо во Франции. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • API геокодирования не обязательно будет возвращать несколько результатов для неоднозначных запросов. На такие запросы лучше отвечает автозаполнение мест.

    Примеры:

    • Геокодирование components=country:US|locality:madrid возвращает «Мадрид, Нью-Мексико 87010, США», но ни один из других городов США с именем «Мадрид». 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Использование автозаполнения места для input=madrid&components=country:us&types=(regions) , а также указание области просмотра с использованием location и radius для смещения результатов местоположения генерирует ответ с несколькими городами в США с именем «Мадрид». 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY