Обзор Geocoding API

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

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

Что можно делать с помощью Geocoding API

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

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

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

Как работает Geocoding API

Geocoding API поддерживает как прямое, так и обратное геокодирование:

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

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

Ресурсы

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

Ресурсы данных Возвращенные данные Формат возвращаемого значения
Geocoding Возвращает адрес, компоненты адреса и типы адресов. Подробнее о результатах рассказывается в руководстве по запросам и ответам геокодирования.
  • JSON
  • XML
Обратное геокодирование Возвращает адрес, его компоненты и типы. Дополнительную информацию можно найти в разделе Ответы на запросы обратного геокодирования руководства по запросам и ответам обратного геокодирования.
Геокодирование мест Возвращает адрес, компоненты адреса и типы адресов. Подробнее об ответах на запросы обратного геокодирования…

Как использовать Geocoding API

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

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

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

Клиенты для Java, Python, Go и Node.js для сервисов Google Карт – это клиентские библиотеки, поддерживаемые сообществом, на базе ПО с открытым исходным кодом, которые предоставляются согласно лицензии Apache 2.0. Их можно скачать на сайте GitHub, где также опубликованы образцы кода и инструкции по установке.

Дальнейшие действия