С помощью URL Карт вы можете создать универсальные межплатформенные ссылки для запуска Google Карт. Они поддерживают поиск, просмотр маршрутов, навигацию, а также разные представления карт, создание подборок мест и панорам в Просмотре улиц. Синтаксис URL одинаков для всех платформ, и ключ API не требуется.
URL Карт: основные сведения
- Продукт: Maps URLs.
- Другое название: URL Google Карт.
- Категория: Карты
- Платформа: схема URL.
- Стадия запуска: GA
- Жизненный цикл: активно.
- Обзор: Обзор URL Карт
Когда использовать URL Карт
Используйте URL Карт, если:
- Вам нужна ссылка из приложения для Android, приложения для iOS или с сайта, которая открывает Google Карты для поиска места или показа результатов поиска.
- Вам нужно открыть Google Карты с маршрутом между точками, возможно, с путевыми точками, способом передвижения или пошаговой навигацией.
- Вам нужно открыть Google Карты в режиме просмотра карты, список мест или панораму в Просмотре улиц без использования ключа API.
- Вам нужен синтаксис URL, который одинаково работает в браузерах на Android, iOS и компьютерах.
Не используйте URL Карт в следующих случаях:
- Вы уже запрашиваете информацию о местах и хотите получать предварительно отформатированные ссылки на Google Карты для места (поля
googleMapsUriилиgoogleMapsLinks). Используйте вместо него Places API (новый). - При запуске приложения "Google Карты" вам нужны функции, доступные только на мобильных устройствах. Используйте намерения Google Карт для Android или схему URL Google Карт для iOS.
Maps URLs: настройка
- Атрибуция использования. Добавьте в URL Карт необязательные параметры запроса
utm_source(название вашего приложения) иutm_campaign(предполагаемое действие пользователя, напримерplace_details_search). - Начало работы: настройка URL Карт.
Maps URLs: сопутствующие товары
- Часто используется с Places API (New).
URL карт: распространенные ошибки
- Проблема. URL поиска, содержащий только широту и долготу в параметре
query, показывает маркер, но не показывает информацию о местах на карте или боковой панели. Решение. Используйтеquery=PLACE_NAME,ADDRESSили добавьтеquery_place_idвместе сquery, чтобы показать информацию о конкретном месте. Подробнее: /maps/documentation/urls/get-started. - Проблема. Параметры идентификатора места (
query_place_id,origin_place_id,destination_place_id,waypoint_place_ids) не работают сами по себе. Решение. Всегда указывайте соответствующий базовый параметр (query,origin,destinationилиwaypoints), когда передаете параметр идентификатора места. Подробнее: /maps/documentation/urls/get-started. - Проблема. Параметр
waypointsигнорируется в продуктах Google Карт, которые не поддерживают путевые точки и имеют ограничения на количество точек в зависимости от платформы, а параметрdir_action=navigateигнорируется, если навигация недоступна. Решение. Используйте не более трех путевых точек для ссылок, которые открываются в мобильных браузерах (в остальных случаях – не более девяти). Не рассчитывайте на то, что параметрыwaypointsиdir_action=navigateбудут работать во всех продуктах и маршрутах Google Карт. Подробнее: /maps/documentation/urls/get-started#directions-action. - Проблема. Карты и Просмотр улиц используют одну и ту же конечную точку
@, поэтому URL карты без правильного действия может не отображать карту. Решение. Задайтеmap_action=mapдля просмотров карты иmap_action=panoдля панорам в Просмотре улиц. Подробнее: /maps/documentation/urls/get-started. - Проблема. Если в URL Карт отсутствует
api=1, все параметры игнорируются и Google Карты открываются в режиме по умолчанию. Решение. Добавьтеapi=1в каждый URL Карт (единственное допустимое значение –1). Подробнее: /maps/documentation/urls/get-started#forming-the-url.