Обзор API геокодирования

API геокодирования — это служба, которая принимает место в виде адреса, координат широты и долготы или идентификатора места. Он преобразует адрес в координаты широты и долготы и идентификатор места или преобразует координаты широты и долготы или идентификатор места в адрес.

Зачем использовать API геокодирования

Используйте API геокодирования для веб-сайта или мобильного приложения, если вы хотите использовать данные геокодирования на картах, предоставляемых одним из API платформы Google Maps. С помощью API геокодирования вы используете адреса для размещения маркеров на карте или преобразуете маркер на карте в адрес. Этот сервис предназначен для геокодирования предопределенных статических адресов для размещения содержимого приложения на карте.

Что вы можете сделать с помощью API геокодирования

Вы можете использовать API геокодирования для получения данных геокодирования для одного или нескольких адресов или мест, включая следующие:

  • Географические координаты адресов.
  • Адреса для наборов координат широты и долготы.
  • Адреса для идентификаторов мест.

Вы можете контролировать, где будут появляться результаты, и ограничивать их определенным регионом, округом или почтовым индексом.

Как работает API геокодирования

API геокодирования выполняет как геокодирование, так и обратное геокодирование:

  • Геокодирование : преобразует такие адреса, как «1600 Amphitheatre Parkway, Mountain View, CA», в координаты широты и долготы или идентификаторы мест. Вы можете использовать эти координаты для размещения маркеров на карте, а также для центрирования или изменения положения карты в рамке просмотра.
  • Обратное геокодирование : преобразует координаты широты и долготы или идентификатор места в удобочитаемый адрес. Вы можете использовать адреса для различных сценариев, включая доставку или самовывоз.

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

Ресурсы

В следующей таблице приведены ресурсы, доступные через API геокодирования, а также данные, возвращаемые каждой конечной точкой.

Ресурсы данных Данные возвращены Формат возврата
Геокодирование Возвращает адрес, компоненты адреса и типы адресов. См. Результаты в руководстве по запросам и ответам на геокодирование .
  • JSON
  • XML
Обратное геокодирование Возвращает адрес, компоненты адреса и типы адресов. См. Ответы на обратное геокодирование в руководстве по запросам и ответам на обратное геокодирование .
Геокодирование места Возвращает адрес, компоненты адреса и типы адресов. См. раздел Ответы на обратное геокодирование в руководстве Размещение запроса и ответа на геокодирование .

Как использовать API геокодирования

1 Настройтесь. Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке.
2 Попробуйте запрос на геокодирование Получив ключ API, вы можете начать тестирование API геокодирования непосредственно из cURL или браузера. Вам потребуется указать правильные параметры поиска для поиска адресов или компонентов. Подробности см. в разделе Параметры геокодирования .
3 Попробуйте запрос обратного геокодирования Укажите координаты широты и долготы вместе с вашим ключом API, чтобы получить компоненты адреса для ближайшего удобочитаемого адреса для этого местоположения. Подробности см. в разделе Запросы обратного геокодирования .
4 Понимать основы ответа Все конечные точки в API геокодирования возвращают одни и те же данные в формате JSON или XML. См. ответы геокодирования для объяснения данных, кодов состояния и сообщений об ошибках.
5 Включите данные геокодирования в свое собственное приложение! Вы можете использовать данные геокодирования для получения адресов из маркеров карты или для предоставления маркеров на карте на основе известного адреса.

Доступные клиентские библиотеки

Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:

Клиент Java, клиент Python, клиент Go и клиент Node.js для служб Google Maps — это клиентские библиотеки, поддерживаемые сообществом, с открытым исходным кодом по лицензии Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и пример кода.

Что дальше