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

Разработчики Европейской экономической зоны (ЕЭЗ)

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

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

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

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

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

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

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

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

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

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

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

Ресурсы

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

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

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

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

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

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

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

Что дальше?