Направляйте пользователей к сведениям о местах и ​​маршрутам на Картах Google с помощью URL-адреса Карт или API мест.

В современном мире, где важна ориентация на местоположение, пользователи ожидают беспрепятственного доступа к информации о местах, указаниям и навигации. Будь то мессенджер, приложение для поиска локальной информации, платформа логистики и транспорта, планировщик путешествий или платформа объявлений о недвижимости, пользователям часто необходимо быстро просмотреть подробную информацию о местоположении или найти оптимальный маршрут из пункта А в пункт Б. Хотя разработчики могут создавать собственные приложения, использование комплексного и привычного интерфейса Google Maps обеспечивает превосходный пользовательский опыт.

Правильно структурированный URL-адрес Google Maps имеет решающее значение для бесперебойной работы пользователя. Неправильные URL-адреса ухудшают этот опыт, направляя пользователей не в то место, отображая общую карту вместо подробной информации или даже приводя к неработающей ссылке. Это расстраивает пользователей и мешает им достичь своей цели. Например, даже при наличии действительного URL-адреса Google Maps пользователь, ожидающий подробной информации о конкретном предприятии, может вместо этого попасть на общую карту без какой-либо релевантной информации. См. пример ниже:

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152

Этот URL-адрес Google Maps действителен для открытия Google Maps и отображения местоположения на основе широты и долготы. Однако он не предоставляет пользователям подробную информацию о конкретном месте.

Поиск осуществляется только по широте и долготе.
Поиск осуществляется только по широте и долготе.

Бесперебойная интеграция вашего приложения с Google Maps с помощью точных URL-адресов.

Открыть страницу с подробной информацией о месте на Google Maps
URL-адрес Google Maps с уникальным названием места перенаправляет пользователей на страницу с подробной информацией об этом месте в Google Maps.

Платформа Google Maps (GMP) предлагает два основных метода создания точных URL-адресов: Places API (новый), для которого требуется ключ API, и Maps URL, которые являются бесплатными и не требуют ключа. Следующие решения предназначены для различных сценариев и вариантов использования:

API Google Maps Places (новый) возвращает исчерпывающий набор информации о конкретном месте. При запросе поля googleMapsUri или googleMapsLinks (путем указания его в маске поля ) ответ API включает объект места. Этот объект содержит предварительно отформатированные URL-адреса, которые можно использовать для непосредственного открытия соответствующего представления, например, представления с подробной информацией о месте, в Google Maps.

Пример:

Запрос на предоставление подробной информации о месте

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \
https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE

Ответ на запрос "Информация о месте":

{
    "googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
    "googleMapsLinks": {
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
        "placeUri": "https://maps.google.com/?cid=3545450935484072529",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
    }
}

В приведенном выше примере ChIJ3S-JXmauEmsRUcIaWtf4MzE — это идентификатор места (Place ID) Сиднейского оперного театра. Идентификатор места (Place ID) — это текстовый идентификатор, который однозначно определяет место в базе данных Google Places и на Google Maps.

Получение идентификаторов мест бесплатно.

Для программного получения идентификаторов мест (Place ID) можно использовать функцию текстового поиска (только ID) в API мест . Это бесплатный способ получения идентификаторов мест. Узнайте больше об идентификаторах мест и запросах API мест (новых) .

Запрос на текстовый поиск (только ID) через API Places:

curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

Ответ API поиска по тексту (только ID) для мест:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Идентификаторы мест также можно получить, когда пользователь щелкает или касается объекта POI на карте. Подробнее о кликабельных значках POI ( JavaScript , Android , iOS ) можно узнать здесь.

Выполнение

При использовании Places API разработчики могут просто извлечь поле googleMapsUri или googleMapsLinks из ответа и использовать его для запуска соответствующего представления в приложении Google Maps или в браузере, если приложение не установлено.

Особенность Описание
directionsUri Ссылка для открытия Google Maps, отображающая маршрут от текущего местоположения пользователя до этого места.
placeUri Ссылка для открытия страницы с подробной информацией о данном месте на Google Maps.
writeAReviewUri Ссылка для открытия страницы с отзывами об этом месте на Google Maps.
reviewsUri Ссылка для открытия страницы отзывов об этом месте на Google Maps.
photosUri Ссылка для открытия страницы с фотографиями этого места на Google Maps.

Ознакомьтесь с руководством для разработчиков и опробуйте эту функцию уже сегодня.

Использование URL-адресов карт

Используя URL-адреса Google Maps, вы можете создать универсальный кроссплатформенный URL-адрес для запуска Google Maps, выполнения поиска, получения указаний и навигации, а также отображения карт и панорамных изображений. Синтаксис URL-адреса одинаков независимо от используемой платформы. Для использования URL-адресов Google Maps вам не потребуется ключ API Google.

Доступные действия на карте:

  • Функция поиска запускает приложение Google Maps или, если приложение не установлено, в браузере, отображая метку для определенного места, либо выполняет общий поиск и запускает карту для отображения результатов.

  • Функция «Проложить маршрут» запускает приложение Google Maps или, если приложение не установлено, открывает его в браузере и отображает маршрут между точками или позволяет использовать пошаговую навигацию в Google Maps на мобильных устройствах.

  • Функция панорамного просмотра Street View позволяет запустить программу просмотра, которая отображает изображения Street View в виде интерактивных панорам.

Для ознакомления с дополнительными функциями и примерами посетите документацию для разработчиков GMP Maps URLs .

Здесь мы рассмотрим две ключевые функции URL-адресов в Картах:

  • Отображение подробной информации о местах на Google Maps: В этом разделе объясняется, как создавать URL-адреса, которые будут отображать подробную информацию о конкретном местоположении на Google Maps. Также подробно описывается, как работать с местами, имеющими неуникальные названия, используя идентификаторы мест (Place ID) и точные запросы.

  • Предоставление маршрутов с помощью URL-адресов карт: В этом разделе объясняется, как создавать URL-адреса, предоставляющие маршруты между местоположениями, включая маршруты с несколькими путевыми точками и пошаговую навигацию.

Отображение подробной информации о местах на Google Картах

Функция поиска принимает два параметра для выполнения поиска мест: query (обязательный) и query_place_id (необязательный).

Параметр query обязателен для всех поисковых запросов. Он принимает название места, координаты широты и долготы, разделенные запятыми, или общий поисковый запрос.

Структура URL-адреса поиска:

https://www.google.com/maps/search/?api=1&parameters

Сценарий 1: Отображение подробной информации о месте с уникальным названием.

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
 В этом примере указано только название места. Этот URL-адрес открывает страницу с подробной информацией о Сиднейском оперном театре.

Открыть страницу с подробной информацией о месте на Google Maps
Поиск по названию места и отображение подробной информации о месте.

Теперь рассмотрим место с неуникальным названием. Что произойдет, если вы будете искать только по этому неуникальному названию? Смотрите следующий сценарий.

Сценарий 2: Поиск мест по неуникальному названию населенного пункта.

https://www.google.com/maps/search/?api=1&query=7-Eleven

Поскольку название места не является уникальным, этот URL-адрес открывает список ближайших магазинов 7-Eleven в пределах видимой области экрана. Затем пользователи могут выбрать конкретный магазин, чтобы просмотреть его подробную информацию.

Страница со списком открытых мест на Google Картах
Страница со списком мест для поиска неуникальных имен.

Чтобы избежать списка местоположений и получить прямой доступ к конкретной странице с подробной информацией, можно использовать более точный метод. См. следующий пример.

Сценарий 3: Отображение сведений о месте с неуникальным названием.

При работе с распространенными географическими названиями простой поиск по имени часто выдает список мест. Для прямой ссылки на страницу с подробной информацией можно использовать один из следующих способов:

Метод 1: Использование точного запроса с указанием названия места и адреса.

https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia

В этом URL-адресе параметр query отформатирован как название места, адрес. Это помогает сузить область поиска и напрямую перейти к нужному местоположению.

Метод 2: Использование идентификатора места.

Идентификаторы мест (Place ID) однозначно идентифицируют место в базе данных Google Places и на картах Google Maps. 

https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM

Здесь ChIJGcmcg7ZC1moRAOacd3HoEwM — это уникальный идентификатор места. Параметр query по-прежнему обязателен, но будет использоваться только в том случае, если Google Maps не сможет найти идентификатор места.

Сценарий 4: Отображение подробной информации о месте с использованием координат широты и долготы, а также идентификатора места.

Использование идентификатора места гарантирует, что Google Maps будет отображать подробную информацию о месте. 

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE
Страница с подробной информацией о месте, содержащая координаты широты и долготы, а также идентификатор места.
Страница с подробной информацией о месте, содержащая координаты широты и долготы, а также идентификатор места.

Получение идентификаторов мест бесплатно.

Для программного получения идентификаторов мест можно использовать функцию текстового поиска (только идентификатор) в API мест . Это бесплатный способ получения идентификаторов мест . Узнайте больше об идентификаторах мест и запросах API мест (новых) .

Запрос на текстовый поиск (только ID) через API Places: 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

Ответ API поиска по тексту (только ID) для мест: 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Идентификаторы мест также можно получить, когда пользователь щелкает или касается объекта POI на карте. Подробнее о кликабельных значках POI ( JavaScript , Android , iOS ) можно узнать здесь.

Заключение

Предоставление точной информации о месте имеет решающее значение для положительного пользовательского опыта. Чтобы пользователи попадали на правильную страницу с подробной информацией о месте, создавайте URL-адреса поиска, используя один из следующих рекомендуемых форматов:

  • query=PLACE_NAME, ADDRESS
  • query=PLACE_NAME&query_place_id=PLACE_ID

Избегайте использования только координат широты и долготы в параметре query , если ваша цель — отобразить подробную информацию о конкретном месте. Форматы типа query=latitude,longitude , query=PLACE_NAME,latitude,longitude или query=ADDRESS,latitude,longitude не всегда будут приводить к нужной странице с подробной информацией о месте. Вместо этого они будут отображать широту и долготу местоположения.

Категориальный поиск с использованием URL-адресов карт.

При поиске по категориям вы указываете общий поисковый запрос, и Google Maps пытается найти объявления, соответствующие вашим критериям, рядом с указанным вами местоположением. Если местоположение не указано, Google Maps пытается найти объявления рядом с вашим текущим местоположением.

Сценарий 1: Поиск ближайших мест 

https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
Категориальный поиск - близлежащие места
Категориальный поиск - близлежащие места

Предоставление маршрутов с использованием URL-адресов карт.

Функция «Проложить маршрут» отображает путь между двумя или более указанными точками на карте, а также расстояние и время в пути. Она предоставляет разработчикам больший контроль над предоставляемыми маршрутами. Документация GMP по URL-адресам карт и маршрутам содержит подробные инструкции по созданию URL-адресов для настраиваемых маршрутов.

Структура URL-адреса для получения инструкций: 

https://www.google.com/maps/dir/?api=1&parameters

Сценарий 1: Поиск оптимального маршрута от текущего местоположения пользователя до пункта назначения. 

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving

Этот URL-адрес открывает Google Maps и отображает маршрут движения от текущего местоположения пользователя.

В этом URL-адресе origin опущена. Если origin опущена, путь по умолчанию ведет к наиболее подходящему начальному местоположению, например, к местоположению устройства, если таковое имеется. Если местоположение не указано, на результирующей карте отображается форма, позволяющая пользователю ввести начальную точку. Значения начальной и конечной точек могут быть либо названием места, адресом, либо координатами широты и долготы, разделенными запятыми.

Параметр travelmode является необязательным. Он определяет способ передвижения. Этот параметр может быть установлен следующим образом:

  • вождение
  • ходьба
  • езда на велосипеде
  • двухколесный
  • транзит

Если способ передвижения не указан, на карте Google отображается один или несколько наиболее подходящих способов передвижения для указанного маршрута и/или предпочтений пользователя.

Разработчики также могут указывать идентификаторы мест, используя параметры origin_place_id и destination_place_id . Использование идентификатора места — лучшая гарантия того, что ссылка будет вести на нужное место.

Получение идентификаторов мест бесплатно.

Для программного получения идентификаторов мест можно использовать функцию текстового поиска (только идентификатор) в API мест . Это бесплатный способ получения идентификаторов мест . Узнайте больше об идентификаторах мест и запросах API мест (новых) .

Запрос на текстовый поиск (только ID) через API Places: 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

Ответ API поиска по тексту (только ID) для мест: 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Идентификаторы мест также можно получить, когда пользователь щелкает или касается объекта POI на карте. Подробнее о кликабельных значках POI ( JavaScript , Android , iOS ) можно узнать здесь.

Маршрут от текущего местоположения пользователя
Маршрут от текущего местоположения пользователя

Сценарий 3: Предоставление пошаговой навигации 

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate

Установив параметр dir_action=navigate в URL-адресе, вы запустите Google Maps в режиме пошаговой навигации, если текущее местоположение пользователя (местоположение устройства) доступно и используется в качестве начальной точки (либо явно указанное, либо неявно используемое, если параметр origin опущен). В противном случае будет отображен предварительный просмотр маршрута.

Пошаговая навигация запускается, когда задан параметр dir_action=navigate и:

  • Указана точка отправления, и она находится недалеко от текущего местоположения пользователя.
  • Исходная точка не указана, доступно текущее местоположение пользователя.

Предварительный просмотр маршрута запускается в следующих случаях:

  • dir_action=navigate не задан.
  • dir_action=navigate установлен, указана точка отправления, и эта точка отправления находится не близко к текущему местоположению пользователя.
  • dir_action=navigate установлен, параметр origin опущен, и текущее местоположение пользователя недоступно.

Обратите внимание, что навигация доступна не во всех продуктах Google Maps, таких как Google Maps Web, и/или не во всех пунктах назначения. В таких случаях этот параметр будет проигнорирован.

Пошаговая навигацияПредварительный просмотр маршрута
Пошаговая навигация
Предварительный просмотр маршрута

Заключение

Правильно сформировав URL-адреса карт, вы можете гарантировать, что пользователи быстро и эффективно получат необходимую им информацию.

  • Всегда указывайте пункт назначения и, по возможности, используйте идентификатор места (Place ID) для гарантированной точности.

  • Если цель — обеспечить мгновенную навигацию, добавьте параметр dir_action=navigate, чтобы запустить пошаговую навигацию. Навигация начнётся с текущего местоположения пользователя, если местоположение устройства доступно и используется в качестве отправной точки (либо задано явно, либо опущено).

Выбор правильного подхода для вашего приложения

У вас есть два основных варианта: использование предварительно отформатированных URL-адресов, предоставляемых API Places, или ручное создание URL-адресов Maps в вашем приложении. Каждый подход имеет свои преимущества и недостатки.

API для работы с местами:

  • Поля googleMapsUri и googleMapsLinks в ответе «Подробная информация о месте» содержат готовые к использованию URL-адреса. Это сокращает время разработки и сводит к минимуму риск ошибок в форматировании URL-адресов.

  • Предоставляет меньше возможностей для настройки маршрута. Хотя googleMapsLinks предлагает базовые маршруты, он не поддерживает путевые точки или расширенную настройку. Кроме того, запустить пошаговую навигацию напрямую относительно сложнее.

URL-адреса карт:

  • Предлагает большую гибкость и контроль. Разработчики могут создавать URL-адреса для отображения подробной информации о местах и ​​настраивать различные аспекты построения маршрутов, включая добавление путевых точек, указание режимов движения и запуск пошаговой навигации.

  • Требуется более глубокое понимание параметров и структуры URL-адреса. Создание URL-адреса вручную увеличивает вероятность ошибок, если не делать это тщательно.

Улучшение URL-адресов карт с помощью UTM-параметров

Чтобы помочь Google лучше понять, как разработчики интегрируют URL-адреса Карты, и обеспечить оптимальную производительность, мы рекомендуем включать параметры отслеживания UTM в структуру ваших URL-адресов. Добавление параметров utm_source и utm_campaign предоставляет ценные данные, которые позволяют нам анализировать модели использования и улучшать продукт «URL-адреса Карты».

Для параметра utm_source используйте название вашего приложения. Параметр utm_campaign должен отражать предполагаемое действие пользователя, например, "location_sharing", "place_details_search" или "directions_request".

Например, URL-адрес с UTM-параметрами может выглядеть так: 

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search

Последовательное использование этих параметров помогает нам выявлять области для улучшения, более эффективно устранять неполадки и, в конечном итоге, обеспечивать лучший пользовательский опыт.

Следующие шаги

Рекомендуемая дополнительная литература:

Авторы

Основные авторы:

Тереза ​​Цинь | Инженер по решениям для платформы Google Maps