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

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

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

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

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

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

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

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

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

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

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

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

Ресурсы

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

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

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

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

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

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

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

Что дальше