Geocoding API – это сервис, который принимает место в виде адреса, координат широты и долготы или идентификатора места. Он преобразует адрес в координаты широты и долготы и идентификатор места или наоборот.
Geocoding API версии 4 предоставляет гиперлокальные данные о пункте назначения и прибытии и основные данные о преобразовании координат в адрес. Если вы создаете сервис доставки на последней миле, совместных поездок или пошаговой навигации или преобразуете почтовые адреса в координаты, в версии 4 вы найдете конечные точки, подходящие для вашего случая.
Не знаете, какая конечная точка подходит для вашего приложения? Подробнее о выборе метода геокодирования…
Что можно делать с помощью Geocoding API
Geocoding API версии 4 включает следующие возможности и конечные точки:
- Поиск пунктов назначения. Получайте гиперлокальные сведения о прибытии в пункт назначения по адресу, идентификатору места или координатам, включая входы в здания, токены точек навигации, контуры зданий и территорий, подпункты назначения и близлежащие ориентиры.
- Геокодирование адреса. Преобразование почтовых адресов в географические координаты и идентификаторы мест (прямое геокодирование).
- Геокодирование местоположения. Преобразование координат широты и долготы в человекочитаемые почтовые адреса или административные районы (обратное геокодирование).
- Геокодирование места. Получение отформатированных данных адреса и координат для известного идентификатора места на Google Картах.
Вы можете управлять тем, где появляются результаты, и ограничивать их определенным регионом, округом или почтовым индексом.
Попробовать
Как работает Geocoding API
Geocoding API версии 4 поддерживает поиск пунктов назначения и базовое геокодирование.
- Поиск пункта назначения (
SearchDestinations). Преобразует адрес, идентификатор места или пару координат в объектDestination. Используйте этот метод, когда важно физическое прибытие, например для определения предпочтительных входов в здания, направления водителей к назначенным пунктам посадки или высадки с помощью токенов точек навигации, отображения контуров зданий на карте или навигации по комплексам из нескольких зданий. - Базовое геокодирование. Преобразование адресов, координат и идентификаторов мест.
- Геокодирование. Преобразует почтовые адреса, например "1600 Amphitheatre Parkway, Mountain View, CA", в координаты широты и долготы или идентификаторы мест, чтобы размещать маркеры на карте или центрировать ее.
- Обратное геокодирование. Преобразует координаты широты и долготы или идентификаторы мест в человекочитаемые почтовые адреса для маркеров на карте, средств выбора местоположения или отображения в интерфейсе.
- Геокодирование места. Получение сведений об адресе и координат для известного идентификатора места на Google Картах.
В таблице ниже перечислены ресурсы, доступные в Geocoding API версии 4, и данные, которые возвращает каждый метод.
| Ресурсы данных | Возвращенные данные | Формат возвращаемого значения |
|---|---|---|
| Поиск пунктов назначения ( POST /v4/geocode/destinations)
|
Возвращает гиперлокальные данные о прибытии: многоугольники зданий и территорий (displayPolygon), физические entrances, маршрутизируемые navigationPoints (с токенами), иерархические containingPlaces и subDestinations, реляционные landmarks и основные сведения о месте. Подробнее о том, как искать пункты назначения…
|
|
| Геокодирование адреса ( GET /v4/geocode/address)
|
Возвращает адрес, его компоненты и типы. Подробнее об ответе геокодирования… | |
| Геокодирование местоположения ( GET /v4/geocode/location)
|
Возвращает адрес, его компоненты и типы. Подробнее об ответе при обратном геокодировании… | |
| Геокодирование места ( GET /v4/geocode/places)
|
Возвращает адрес, его компоненты и типы. Подробнее об ответе на запрос геокодирования места… |
Каналы этапов запуска
В версии 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 с вашего собственного бэкенд-сервера. Подробнее о безопасных шаблонах реализации и альтернативах для клиентских потребностей читайте в разделе Рекомендации по безопасности.