В современном мире, где всё зависит от местоположения, пользователи ожидают бесперебойного доступа к информации о местах, маршрутам и навигации. Будь то мессенджер, приложение для поиска локального контекста, логистическая и транспортная платформа, планировщик путешествий или платформа для размещения недвижимости, пользователям часто требуется быстро просмотреть информацию о местоположении или найти оптимальный маршрут из пункта А в пункт Б. Разработчики могут создавать собственные приложения, но использование комплексного и знакомого интерфейса Google Карт обеспечивает превосходный опыт.
Правильно структурированный URL-адрес Google Карт крайне важен для бесперебойной работы пользователей. Неправильные URL-адреса ухудшают качество работы, направляя пользователей по неверному адресу, отображая общую карту вместо конкретной информации или даже приводя к неработающей ссылке. Это раздражает пользователей и мешает им достичь своей цели. Например, даже при наличии корректного URL-адреса Google Карт пользователь, ожидающий получить подробную информацию о конкретной компании, может вместо этого попасть на общую карту без какой-либо релевантной информации. См. пример ниже:
https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152
Этот URL-адрес Карт действителен для открытия Google Карт и отображения местоположения по широте и долготе. Однако он не предоставляет пользователям подробную информацию о конкретном месте.
Простая интеграция вашего приложения с Google Maps с помощью точных URL-адресов
Платформа Google Карт (GMP) предлагает два основных метода построения точных URL-адресов: Places API (новый), требующий ключа API, и Maps URLs, которые бесплатны и не требуют ключа. Следующие решения предназначены для различных сценариев и вариантов использования:
Использование поля googleMapsUri или googleMapsLinks API GMP Places (нового)
API GMP Places (новый) возвращает полный набор информации о конкретном месте. При запросе поля googleMapsUri или googleMapsLinks (указанном в маске поля ) ответ API включает объект места. Этот объект содержит предварительно отформатированные URL-адреса, которые можно использовать для непосредственного открытия соответствующего представления, например, представления сведений о месте, в Google Картах.
Пример:
Запрос сведений о месте
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 в примере выше — это идентификатор места Сиднейского оперного театра. Идентификатор места — это текстовый идентификатор, который однозначно идентифицирует место в базе данных Google Places и на Google Картах.
Получение идентификаторов мест с нулевыми затратами
Для программного получения идентификаторов мест можно использовать функцию Places API: Text Search(ID Only) . Это бесплатный метод получения идентификаторов мест. Узнайте больше о Place ID и запросах Place API (New) .
Запрос текстового поиска API Places (только ID):
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 Places (только идентификатор):
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Идентификаторы мест также можно получить, когда пользователь нажимает или касается точки интереса на карте. Узнайте больше о кликабельных значках точек интереса ( JavaScript , Android , iOS ).
Выполнение
При использовании API Places разработчики могут просто извлечь поле googleMapsUri или googleMapsLinks из ответа и использовать его для запуска соответствующего представления в приложении Google Maps или в браузере, если приложение не установлено.
| Особенность | Описание |
|---|---|
| направленияUri | Ссылка для открытия Карт Google и отображения маршрутов от текущего местоположения пользователя до этого места. |
| местоUri | Ссылка для открытия страницы сведений об этом месте в Google Картах |
| writeAReviewUri | Ссылка для открытия Карт Google на страницу написания отзыва об этом месте |
| обзорыУри | Ссылка для открытия Карт Google на странице отзывов об этом месте |
| photosUri | Ссылка для открытия страницы фотографий этого места в Google Картах |
Ознакомьтесь с руководством для разработчиков и попробуйте эту функцию уже сегодня.
Использование URL-адресов Карт
Используя URL-адреса Карт, вы можете создать универсальный кроссплатформенный URL-адрес для запуска Google Карт и выполнения поиска, получения маршрутов и навигации, а также отображения видов карты и панорамных изображений. Синтаксис URL-адреса одинаков для любой платформы. Для использования URL-адресов Карт ключ API Google не требуется.
Доступны следующие действия с картой:
Функция поиска запускает приложение Google Maps или браузер, если приложение не установлено, которое отображает метку определенного места, или выполняет общий поиск и запускает карту для отображения результатов.
Функция «Маршруты» запускает приложение Google Maps или браузер, если приложение не установлено, которое отображает маршруты между точками или включает пошаговую навигацию в Google Maps для мобильных устройств.
Функция панорамы Street View позволяет запустить средство просмотра для отображения изображений Street View в виде интерактивных панорам.
Посетите документацию разработчика URL-адресов GMP Maps, чтобы изучить дополнительные функции и примеры.
Здесь мы рассмотрим две ключевые функции URL-адресов Карт:
Отображение информации о месте на Картах Google: в этом разделе объясняется, как создавать URL-адреса, которые будут отображать информацию о конкретном месте на Картах Google. Также подробно описывается работа с местами с неуникальными названиями с помощью идентификаторов мест и точных запросов.
Предоставление маршрутов с использованием URL-адресов Карт. В этом разделе объясняется, как создавать URL-адреса, предоставляющие маршруты между местоположениями, включая маршруты с несколькими путевыми точками и пошаговую навигацию.
Отображение информации о месте на Google Картах
Функция поиска принимает два параметра для выполнения поиска мест: query (обязательный) и query_place_id (необязательный).
Параметр query обязателен для всех поисковых запросов. Он принимает название места, координаты широты и долготы, разделённые запятыми, или общий поисковый запрос.
Структура URL поиска:
https://www.google.com/maps/search/?api=1¶meters
Сценарий 1: Отображение информации о месте с уникальным названием
https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
Теперь рассмотрим место с неуникальным названием. Что произойдёт, если вы выполните поиск только по этому неуникальному названию? См. следующий сценарий.
Сценарий 2: Поиск мест по неуникальному названию
https://www.google.com/maps/search/?api=1&query=7-Eleven
Поскольку название места не уникально, этот URL открывает список ближайших магазинов 7-Eleven в области просмотра. Пользователи могут выбрать конкретный магазин, чтобы просмотреть подробную информацию о нём.
Чтобы избежать списка местоположений и перейти непосредственно к нужной странице с подробной информацией, можно использовать более точный метод. См. следующий пример.
Сценарий 3: Отображение информации о месте с неуникальным названием
При поиске распространённых географических названий простой поиск по названию часто возвращает список населённых пунктов. Чтобы перейти на конкретную страницу с подробной информацией, можно использовать один из следующих способов:
Метод 1: Использование точного запроса с названием места и адресом
https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia
В этом URL-адресе параметр query форматируется как название места, адрес. Это помогает сузить поиск и перейти непосредственно к нужному месту.
Метод 2: Использование идентификатора места
Идентификаторы мест однозначно идентифицируют места в базе данных 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
Получение идентификаторов мест с нулевыми затратами
Для программного получения идентификаторов мест можно использовать функцию Places API: Text Search(ID Only) . Это бесплатный метод получения идентификаторов мест . Узнайте больше об идентификаторе места и запросе Place API (New) .
Запрос текстового поиска API Places (только ID):
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 Places (только идентификатор):
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Идентификаторы мест также можно получить, когда пользователь нажимает или касается точки интереса на карте. Узнайте больше о кликабельных значках точек интереса ( 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 Карты пытаются найти предложения, соответствующие вашим критериям, рядом с указанным вами местоположением. Если местоположение не указано, Google Карты пытаются найти предложения рядом с вашим текущим местоположением.
Сценарий 1: Поиск мест поблизости
https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
Предоставление маршрутов с использованием URL-адресов Карт
Функция «Направления» отображает путь между двумя или более указанными точками на карте, а также расстояние и время в пути. Она предоставляет разработчикам больше возможностей для управления предоставляемыми направлениями. Документация GMP Maps URLs Directions содержит подробные инструкции по созданию URL-адресов для настраиваемых маршрутов.
Структура URL-адреса направления:
https://www.google.com/maps/dir/?api=1¶meters
Сценарий 1: Поиск наилучшего маршрута от текущего местоположения пользователя до пункта назначения
https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving
Этот URL открывает Google Maps и отображает маршрут проезда из текущего местоположения пользователя.
В этом URL-адресе origin не указана. Если origin не указана, путь по умолчанию соответствует наиболее подходящему начальному местоположению, например, местоположению устройства, если оно доступно. Если исходная точка отсутствует, на полученной карте отображается форма, позволяющая пользователю ввести исходную точку. Значение исходной точки и конечной точки может быть названием места, адресом или координатами широты и долготы, разделёнными запятыми.
travelmode — необязательный параметр. Он определяет способ передвижения. Этот параметр может быть задан следующим образом:
- вождение
- ходьба
- езда на велосипеде
- двухколесный
- транзит
Если режим передвижения не указан, Google Maps отображает один или несколько наиболее подходящих режимов для указанного маршрута и/или предпочтений пользователя.
Разработчики также могут указывать идентификаторы мест с помощью параметров origin_place_id и destination_place_id . Использование идентификатора места — лучшая гарантия того, что вы укажете ссылку на нужное место.
Получение идентификаторов мест с нулевыми затратами
Для программного получения идентификаторов мест можно использовать функцию Places API: Text Search(ID Only) . Это бесплатный метод получения идентификаторов мест . Узнайте больше об идентификаторе места и запросе Place API (New) .
Запрос текстового поиска API Places (только ID):
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 Places (только идентификатор):
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Идентификаторы мест также можно получить, когда пользователь нажимает или касается точки интереса на карте. Узнайте больше о кликабельных значках точек интереса ( 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 в режиме пошаговой навигации, если текущее местоположение пользователя (местоположение устройства) доступно и используется в качестве исходной точки (указано явно или используется неявно, если параметр исходной точки опущен). В противном случае будет отображаться предварительный просмотр маршрута.
Пошаговая навигация запускается, когда установлено dir_action=navigate и:
- Источник указан и находится недалеко от текущего местоположения пользователя.
- Происхождение не указано, а текущее местоположение пользователя указано.
Предварительный просмотр маршрута запускается, когда:
-
dir_action=navigateне установлен -
dir_action=navigateустановлен и указано начало координат, а начало координат не находится близко к текущему местоположению пользователя -
dir_action=navigateустановлен, источник опущен, а текущее местоположение пользователя недоступно
Обратите внимание, что навигация доступна не во всех продуктах Google Карт, таких как Google Maps Web, и/или между всеми пунктами назначения. В таких случаях этот параметр будет проигнорирован.
 |  |
Заключение
Правильно создавая URL-адреса Карт, вы можете гарантировать, что пользователи быстро и эффективно получат нужную им информацию.
Всегда указывайте пункт назначения и по возможности используйте идентификатор места для гарантированной точности.
Если цель — обеспечить мгновенную навигацию, включите параметр dir_action=navigate для запуска пошаговой навигации. Навигация начнётся из текущего местоположения пользователя, если местоположение устройства доступно и используется в качестве исходной точки (либо явно задано, либо не указано).
Выбор правильного подхода к вашему приложению
У вас есть два основных варианта: использовать предварительно отформатированные URL-адреса, предоставляемые API Places, или вручную создавать URL-адреса Карт в вашем приложении. Каждый подход имеет свои преимущества и недостатки.
API мест:
Поля
googleMapsUriиgoogleMapsLinksв ответе Place Details содержат готовые URL-адреса. Это сокращает время разработки и минимизирует риск ошибок в форматировании URL-адресов.Предоставляет меньше возможностей для настройки маршрутов. Хотя
googleMapsLinksпредлагает базовые маршруты, он не поддерживает путевые точки и расширенные настройки. Кроме того, напрямую включить пошаговую навигацию довольно сложно.
URL-адреса карт:
Обеспечивает большую гибкость и контроль. Разработчики могут создавать URL-адреса для отображения информации о местах и настраивать различные аспекты маршрутов, включая добавление путевых точек, указание режимов движения и запуск пошаговой навигации.
Требует более глубокого понимания параметров и структуры URL. Ручное создание увеличивает вероятность ошибок, если выполняется неаккуратно.
Улучшение URL-адресов Карт с помощью параметров UTM
Чтобы помочь Google лучше понять, как разработчики интегрируют URL-адреса Карт, и обеспечить оптимальную производительность, мы рекомендуем вам включать параметры отслеживания UTM в структуру URL. Добавляя параметры utm_source и utm_campaign , вы предоставляете ценные данные, которые позволяют нам анализировать модели использования и улучшать продукт Maps 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 Карт