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
API геокодирования версии 4 разработан как API для взаимодействия между серверами. Прямые вызовы на стороне клиента из браузера подвергают ключи API значительному риску кражи и неправомерного использования, поскольку ограничения HTTP-рефереров недостаточны для защиты конечных точек веб-сервисов.
Мы настоятельно рекомендуем вызывать API геокодирования версии 4 с вашего собственного бэкэнд-сервера. Более подробную информацию о безопасных вариантах реализации и альтернативах для нужд клиентской части см. в разделе «Вопросы безопасности» .