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

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

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 Разберитесь в основах реагирования. Все конечные точки API геокодирования возвращают одни и те же данные либо в формате JSON, либо в формате XML. См. раздел «Ответы геокодирования» для получения пояснения к данным, кодам состояния и сообщениям об ошибках.
5 Интегрируйте данные геокодирования в своё приложение! Вы можете использовать данные геокодирования для получения адресов по маркерам на карте или для размещения маркеров на карте на основе известного адреса.

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

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

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

Что дальше?