API геокодирования — это сервис, который принимает местоположение в виде адреса, координат широты и долготы или идентификатора места. Он преобразует адрес в координаты широты и долготы и идентификатор места, либо преобразует координаты широты и долготы или идентификатор места в адрес.
Что можно делать с API геокодирования
С помощью API геокодирования вы можете получить данные геокодирования для одного или нескольких адресов или мест, включая следующие:
В этом выпуске Geocoding API v4 представлены следующие конечные точки:
- (Предварительный просмотр) Геокодирование адреса — Географические координаты адреса. Также называется прямым геокодированием .
- (Предварительный просмотр) Геокодирование местоположения — адреса для наборов координат широты и долготы. Также называется обратным геокодированием .
- (Предварительный просмотр) Геокодирование мест — Получение адреса по идентификатору места.
- (Предварительный просмотр) Поиск пунктов назначения — Поиск пункта назначения по адресу, идентификатору места или местоположению.
Вы можете контролировать, где отображаются результаты, и ограничивать их показ определенным регионом, округом или почтовым индексом.
Как работает API геокодирования
API геокодирования выполняет как геокодирование, так и обратное геокодирование:
- Геокодирование : Преобразует адреса, например, "1600 Amphitheatre Parkway, Mountain View, CA", в координаты широты и долготы или идентификаторы мест. Эти координаты можно использовать для размещения маркеров на карте, а также для центрирования или изменения положения карты в пределах области просмотра.
- Обратное геокодирование : преобразует координаты широты и долготы или идентификатор места в удобочитаемый адрес. Адреса можно использовать в различных сценариях, включая доставку или самовывоз.
В таблице ниже приведено краткое описание ресурсов, доступных через API геокодирования, а также данные, возвращаемые каждой конечной точкой.
| Ресурсы данных | Возвращенные данные | Формат возврата |
|---|---|---|
| Геокодирование | Возвращает адрес, компоненты адреса и типы адресов. См. документацию по ответам Geocode . |
|
| Обратное геокодирование | Возвращает адрес, компоненты адреса и типы адресов. См. документацию по ответу обратного геокодирования . | |
| Геокодирование местоположения | Возвращает адрес, компоненты адреса и типы адресов. См. документацию по ответам геокодирования Place . | |
| Поиск пункта назначения | Возвращает подробную информацию о различных пунктах назначения на основе различных входных критериев, таких как адрес, идентификатор места или координаты широты и долготы. См. документацию по поиску пунктов назначения . |
Функции API геокодирования версии 4
В 4-й версии API геокодирования появились эти новые функции.
Конечная точка поиска пункта назначения
В версии 4 представлена конечная точка поиска пунктов назначения , позволяющая получать подробную информацию о различных пунктах назначения на основе различных входных критериев, таких как адрес, идентификатор места или координаты широты и долготы. Ответ включает сводные данные, полученные с помощью ИИ , и токены навигационных точек , содержащие контекстную информацию, которую можно передать в SDK навигации для точной прокладки маршрута.
Реализовано на стандартной платформе Google Cloud.
API геокодирования версии 4 реализован на сервисной инфраструктуре Google Cloud. Эта реализация обеспечивает более безопасную и надежную платформу с расширенными возможностями защиты, такими как OAuth . Стандартизированный дизайн API обеспечивает согласованность между API, что повышает эффективность разработки с использованием API геокодирования версии 4.
Добавлена поддержка OAuth.
API геокодирования версии 4 поддерживает использование OAuth 2.0 для аутентификации. Google поддерживает распространенные сценарии OAuth 2.0, например, для веб-сервера.
Добавлена поддержка полевых масок.
Используйте маски полей , чтобы указать, какую информацию должен возвращать ответ. Для конечных точек «Геокодирование адреса» , «Геокодирование местоположения» и «Геокодирование мест» по умолчанию возвращаются все поля объекта ответа. Для конечной точки «Поиск пунктов назначения » необходимо указать маску поля в запросе API.
Использование в режиме предварительного просмотра бесплатно.
API геокодирования версии 4 находится на стадии предварительного тестирования, и использование API в этот период бесплатно. Вызовы API будут отображаться на странице «Платежи» в консоли Cloud Console, но стоимость будет равна 0 долларов.
Обратная связь
Это предварительная версия функции. Будем благодарны за отзывы, отправленные по адресу geocoding-feedback-channel@google.com .