Обзор Geocoding API

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

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

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

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

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

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

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

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

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

В следующей демонстрации используется сервис Geocoding в Maps JavaScript API, чтобы показать, как работает Geocoding 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, где также опубликованы образцы кода и инструкции по установке.

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