Краткое руководство по URL Карт

С помощью 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 Карт.

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.