Geocoding API – это сервис, который принимает место в виде адреса, координат широты и долготы или идентификатора места. Он преобразует адрес в координаты широты и долготы и идентификатор места или наоборот.
Что можно делать с помощью Geocoding API
Geocoding API позволяет получать данные геокодирования для одного или нескольких адресов или мест, в том числе:
В этом выпуске Geocoding API версии 4 добавлены следующие конечные точки:
- Геокодирование адреса – географические координаты адресов. Также называется прямым геокодированием.
- Геокодирование местоположения – адреса для наборов координат широты и долготы. Этот процесс также называется обратным геокодированием.
- Геокодирование места – получение адреса по идентификатору места.
- Поиск пунктов назначения. Поиск пункта назначения по адресу, идентификатору места или местоположению.
Вы можете управлять тем, где появляются результаты, и ограничивать их определенным регионом, округом или почтовым индексом.
Попробовать
Как работает Geocoding API
Geocoding API выполняет как прямое, так и обратное геокодирование.
- Геокодирование. Преобразует адреса, например "1600 Amphitheatre Parkway, Mountain View, CA", в координаты широты и долготы или идентификаторы мест. Эти координаты можно использовать для размещения маркеров на карте, а также для центрирования или изменения положения карты в окне просмотра.
- Обратное геокодирование. Преобразует координаты широты и долготы или идентификатор места в человекочитаемый адрес. Вы можете использовать адреса для различных сценариев, включая доставку или самовывоз.
В таблице ниже перечислены ресурсы, доступные через Geocoding API, и данные, возвращаемые каждым методом.
| Ресурсы данных | Возвращенные данные | Формат возвращаемого значения |
|---|---|---|
| Geocoding | Возвращает адрес, его компоненты и типы. Подробную информацию вы найдете в документации по ответам на запросы геокодирования. |
|
| Обратное геокодирование | Возвращает адрес, его компоненты и типы. Подробную информацию можно найти в документации по ответам на запросы обратного геокодирования. | |
| Геокодирование мест | Возвращает адрес, его компоненты и типы. Подробную информацию можно найти в документации по ответам на запросы геокодирования мест. | |
| Поиск по пункту назначения | Возвращает подробную информацию о различных пунктах назначения на основе разных входных критериев, таких как адрес, идентификатор места или координаты широты и долготы. Подробную информацию можно найти в документации по поиску пунктов назначения. |
Каналы этапов запуска
В версии 4 Geocoding API есть отдельные каналы для общедоступных, предварительных и экспериментальных функций. Если вы хотите использовать предварительные или экспериментальные функции, укажите в запросе нужный канал. Например, чтобы получить доступ к функциям конечной точки Destinations в экспериментальной версии, используйте следующий HTTP-запрос: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Этап запуска | Название канала |
|---|---|
| GA | /v4/ |
| Предпросмотр | /v4beta/ |
| Экспериментальная функция | /v4alpha/ |
- Список и описание всех доступных ресурсов REST можно найти в справочнике по REST.
- Подробнее об этапах запуска…
Функции Geocoding API версии 4
В версии 4 Geocoding API появились следующие новые функции:
Способ поиска пункта назначения
В версии 4 появился метод поиска пунктов назначения, который позволяет получать подробную информацию о различных пунктах назначения на основе разных входных критериев, таких как адрес, идентификатор места или координаты широты и долготы. Ответ включает краткие пересказы, созданные ИИ, и токены точек навигации, которые содержат контекстную информацию, которую можно передать в Navigation SDK для точной маршрутизации.
Реализовано на стандартной платформе Google Cloud.
Geocoding API версии 4 реализован на инфраструктуре сервисов в Google Cloud. Это изменение позволит повысить безопасность и надежность платформы, а также расширить возможности защиты, например за счет OAuth. Такой стандартный дизайн API обеспечивает согласованность между API, что повышает эффективность разработки с помощью Geocoding API версии 4.
Добавлена поддержка OAuth
Geocoding API версии 4 поддерживает использование OAuth 2.0 для аутентификации. Google поддерживает распространенные сценарии OAuth 2.0, например для веб-сервера.
Добавлена поддержка маски полей
Используйте маски полей, чтобы указать, какую информацию должен возвращать ответ. Для методов Geocode an address, Geocode a location и Place geocoding по умолчанию возвращаются все поля в объекте ответа. Для метода Search for destinations в запросе к API необходимо указать маску поля.
Безопасность API
Geocoding API версии 4 предназначен для межсерверного взаимодействия. Прямые вызовы на стороне клиента из браузера подвергают ключи API значительному риску кражи и неправомерного использования, поскольку ограничения по заголовку HTTP referer не обеспечивают достаточной защиты для конечных точек веб-сервисов.
Мы настоятельно рекомендуем вызывать Geocoding API версии 4 с вашего собственного бэкенд-сервера. Подробнее о безопасных шаблонах реализации и альтернативах для клиентских потребностей читайте в разделе Рекомендации по безопасности.