Начать

Введение

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

Вам не нужен ключ API Google для использования URL-адресов Карт.

Универсальный кроссплатформенный синтаксис

Как разработчик приложения для Android, приложения для iOS или веб-сайта, вы можете создать общий URL-адрес, и он откроет Карты Google и выполнит запрошенное действие, независимо от используемой платформы при открытии карты.

  • На Android-устройстве:
    • Если приложение Google Maps для Android установлено и активно, URL-адрес запускает Google Maps в приложении Maps и выполняет запрошенное действие.
    • Если приложение Google Maps не установлено или отключено, URL-адрес запускает Google Maps в браузере и выполняет запрошенное действие.
  • На устройстве iOS:
    • Если установлено приложение Google Maps для iOS , URL-адрес запускает Google Maps в приложении Maps и выполняет запрошенное действие.
    • Если приложение Google Maps не установлено, URL-адрес запускает Google Maps в браузере и выполняет запрошенное действие.
  • На любом другом устройстве URL-адрес запускает Карты Google в браузере и выполняет запрошенное действие.

Рекомендуется использовать межплатформенный URL-адрес для запуска Карт Google из вашего приложения или веб-сайта, поскольку эти универсальные URL-адреса позволяют более широко обрабатывать запросы карт независимо от используемой платформы. Для функций, которые могут работать только на мобильной платформе (например, пошаговая навигация), вы можете предпочесть использовать вариант для конкретной платформы для Android или iOS. См. следующую документацию:

Запуск Google Maps и выполнение определенного действия

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

  • Поиск — запустите карту Google, которая отображает булавку для определенного места, или выполните общий поиск и запустите карту, чтобы отобразить результаты:
    https://www.google.com/maps/search/?api=1 & parameters
  • Маршруты — запрашивайте маршруты и запускайте Google Maps с результатами:
    https://www.google.com/maps/dir/?api=1 & parameters
  • Отобразить карту — запустить Карты Google без маркеров и направлений:
    https://www.google.com/maps/@?api=1&map_action=map & parameters
  • Отобразить панораму Street View — запустить изображение интерактивной панорамы:
    https://www.google.com/maps/@?api=1&map_action=pano & parameters

Важно ! Параметр api=1 определяет версию URL-адресов Карт, для которых предназначен этот URL-адрес. Этот параметр требуется в каждом запросе. Единственным допустимым значением является 1. Если api=1 НЕ присутствует в URL-адресе, все параметры игнорируются, а приложение Google Maps по умолчанию запускается либо в браузере, либо в мобильном приложении Google Maps, в зависимости от используемой платформы (для например, https://www.google.com/maps ).

Создание действительных URL-адресов

Вы должны правильно кодировать URL-адреса.

Например, в некоторых параметрах в качестве разделителя используется символ вертикальной черты ( | ), который необходимо закодировать как %7C в конечном URL-адресе. В других параметрах используются значения, разделенные запятыми, например координаты широты/долготы или город, штат. Вы должны кодировать запятую как %2C . Кодируйте пробелы с помощью %20 или замените их знаком плюс ( + ).

Кроме того, URL-адреса ограничены 2048 символами для каждого запроса. Помните об этом ограничении при создании URL-адресов.

Действия карты

Доступные действия с картой: поиск, маршруты, отображение карты и отображение панорамы просмотра улиц. Вы указываете действие в URL-адресе запроса вместе с обязательными и необязательными параметрами. Как это принято в URL-адресах, вы разделяете параметры с помощью символа амперсанда ( & ). Для каждого действия список параметров и их возможные значения перечислены в разделе Параметры поиска .

Поиск

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

Формирование поискового URL

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

Параметры

  • query (обязательно): определяет места, которые необходимо выделить на карте. Параметр запроса является обязательным для всех поисковых запросов.
    • Укажите местоположения в виде названия места, адреса или координат широты/долготы, разделенных запятыми. Строки должны быть закодированы в URL-адресе , поэтому адрес, например "City Hall, New York, NY", должен быть преобразован в City+Hall%2C+New+York%2C+NY .
    • Укажите общие условия поиска в виде строки в кодировке URL , например, grocery+stores или restaurants+in+seattle+wa .
  • query_place_id (необязательно): идентификатор места — это текстовый идентификатор, который однозначно идентифицирует место. Для действия search необходимо указать query , но вы также можете указать query_place_id . Если вы укажете оба параметра, query будет использоваться только в том случае, если Google Maps не сможет найти идентификатор места. Если вы пытаетесь окончательно установить ссылку на конкретное заведение, идентификатор места является лучшей гарантией того, что вы сделаете ссылку на нужное место. Также рекомендуется отправлять query_place_id , когда вы запрашиваете конкретное местоположение, используя координаты широты/долготы.

Примеры поиска

Поиск местоположения

При поиске местоположения вы ищете конкретное местоположение, используя название места, адрес или координаты широты/долготы, разделенные запятыми, и на полученной карте отображается булавка в этом местоположении. Эти три примера иллюстрируют поиск одного и того же местоположения CenturyLink Field (спортивный стадион в Сиэтле, штат Вашингтон) с использованием разных значений местоположения.

Пример 1. Поиск названия места «CenturyLink Field» приводит к следующей карте:

https://www.google.com/maps/search/?api=1&query=centurylink+field

Пример 2. Поиск поля CenturyLink с использованием координат широты/долготы, а также идентификатора места приводит к следующей карте:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

Пример 3: Поиск поля CenturyLink с использованием только координат широты/долготы приводит к следующей карте. Обратите внимание, что на карте есть булавка, но на карте или на боковой панели нет дополнительной информации о месте:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393

Категориальный поиск

В категориальном поиске вы вводите общий поисковый запрос, и Карты Google пытаются найти списки, соответствующие вашим критериям, рядом с указанным вами местоположением. Если местоположение не указано, Google Maps попытается найти объекты рядом с вашим текущим местоположением. Если вы предпочитаете указать местоположение для поиска по категориям, включите его в строку общего поиска (например, pizza+seattle+wa ).

В этом примере поиск пиццерий в Сиэтле, штат Вашингтон, приводит к следующей карте:

https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa


Направления

Действие Directions отображает путь между двумя или более указанными точками на карте, а также расстояние и время в пути.

Формирование URL-адреса направления

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

Параметры

  • origin : определяет начальную точку, из которой следует отображать направления. По умолчанию используется наиболее подходящее начальное местоположение, например местоположение устройства, если оно доступно. Если нет, результирующая карта может содержать пустую форму, позволяющую пользователю ввести исходную точку. Значение может быть названием места, адресом или разделенными запятыми координатами широты и долготы. Строка должна быть закодирована в URL , поэтому такой адрес, как "City Hall, New York, NY", должен быть преобразован в City+Hall%2C+New+York%2C+NY .

    Примечание. Этот параметр является необязательным, если вы не укажете origin_place_id в своем URL-адресе. Если вы решите указать origin_place_id , вы также должны указать origin в URL-адресе.

  • origin_place_id (необязательно): идентификатор места — это текстовый идентификатор, однозначно идентифицирующий место. Если вы пытаетесь точно указать заведение, использование идентификатора места является лучшей гарантией того, что вы сделаете ссылку на нужное место. URL-адреса, в которых используется этот параметр, также должны включать origin .
  • destination : определяет конечную точку направления. Если нет, результирующая карта может предоставить пустую форму, позволяющую пользователю ввести пункт назначения. Значение может быть названием места, адресом или разделенными запятыми координатами широты и долготы. Строка должна быть закодирована в URL , поэтому такой адрес, как "City Hall, New York, NY", должен быть преобразован в City+Hall%2C+New+York%2C+NY .

    Примечание. Этот параметр является необязательным, если только вы не destination_place_id в URL-адресе target_place_id. Если вы решите указать destination_place_id , вы также должны указать место destination в URL-адресе.

  • destination_place_id (необязательно): Идентификатор места — это текстовый идентификатор, который однозначно идентифицирует место. Если вы пытаетесь точно указать заведение, использование идентификатора места является лучшей гарантией того, что вы сделаете ссылку на нужное место. URL-адреса, в которых используется этот параметр, также должны включать destination .
  • travelmode (необязательно): определяет способ передвижения. Возможные варианты: driving , walking (при этом предпочтение отдается пешеходным дорожкам и тротуарам, если таковые имеются), езда на bicycling (при наличии маршрутов по велосипедным дорожкам и предпочтительным улицам) или transit . Если travelmode не указан, на карте Google отображается один или несколько наиболее подходящих режимов для указанного маршрута и/или предпочтений пользователя.
  • dir_action=navigate (необязательно): запускает либо пошаговую навигацию, либо предварительный просмотр маршрута к указанному пункту назначения в зависимости от того, доступен ли исходный пункт. Если пользователь указывает исходную точку, и она не находится близко к текущему местоположению пользователя или текущее местоположение устройства недоступно, карта запускает предварительный просмотр маршрута. Если пользователь не указывает исходную точку (в этом случае исходной точкой по умолчанию является текущее местоположение устройства) или исходная точка находится недалеко от текущего местоположения пользователя, карта запускает пошаговую навигацию. Обратите внимание, что навигация доступна не во всех продуктах Google Maps и/или между всеми пунктами назначения; в этих случаях этот параметр будет игнорироваться.
  • waypoints : Указывает одно или несколько промежуточных мест для прокладки направлений между origin и destination точками. Можно указать несколько путевых точек, используя символ вертикальной черты ( | ) для разделения мест (например, Berlin,Germany|Paris,France ). Количество разрешенных путевых точек зависит от платформы, на которой открывается ссылка: в мобильных браузерах поддерживается до трех путевых точек, а в других случаях поддерживается максимум девять путевых точек. Путевые точки отображаются на карте в том же порядке, в котором они перечислены в URL-адресе. Каждая путевая точка может быть названием места, адресом или разделенными запятыми координатами широты/долготы. Строки должны быть закодированы в URL-адресе , поэтому путевые точки, такие как «Берлин,Германия|Париж,Франция», должны быть преобразованы в Berlin%2CGermany%7CParis%2CFrance .

    Примечания:

    • Путевые точки поддерживаются не всеми продуктами Google Maps; в этих случаях этот параметр будет игнорироваться.
    • Этот параметр является необязательным, если вы не укажете waypoint_place_ids в своем URL-адресе. Если вы решите указать waypoint_place_ids , вы также должны включить waypoints в URL-адрес.
  • waypoint_place_ids (необязательно): идентификатор места — это текстовый идентификатор, который однозначно идентифицирует место. Waypoint_place_ids позволяет указать список идентификаторов мест, соответствующих списку waypoints . Идентификаторы мест должны быть перечислены в том же порядке, что и путевые точки, и разделены вертикальной чертой " | " ( URL-кодировка как %7C ). Если вы пытаетесь точно указать определенные заведения, идентификаторы мест являются лучшей гарантией того, что вы будете ссылаться на нужные места. URL-адреса, использующие этот параметр, также должны включать waypoints .

Примеры направлений

Следующий URL-адрес запускает карту в режиме направлений и предоставляет форму, позволяющую пользователю ввести исходную и конечную точки.

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

В следующем примере запускается карта с велосипедными маршрутами от Спейс-Нидл до рынка Пайк-плейс в Сиэтле, штат Вашингтон.

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

В следующем примере запускается карта с пешеходными маршрутами от Google в Сиднее, Австралия, до здания королевы Виктории.

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking


Отображение карты

Действие карты возвращает карту без маркеров или направлений.

Формирование URL карты

https://www.google.com/maps/@?api=1&map_action=map & parameters

Параметры

  • map_action=map (обязательно): указывает тип отображения карты. Карты и Просмотр улиц используют одну и ту же конечную точку. Чтобы убедиться, что карта отображается, map_action должен быть указан как map .
  • center (необязательно): определяет центр окна карты и принимает координаты широты/долготы в виде значений, разделенных запятыми (например, -33.8569,151.2152 ).
  • zoom (необязательно): устанавливает начальный уровень масштабирования карты. Допустимые значения — целые числа в диапазоне от 0 (весь мир) до 21 (отдельные здания). Верхний предел может варьироваться в зависимости от картографических данных, доступных в выбранном местоположении. По умолчанию 15.
  • basemap карта (необязательно): определяет тип отображаемой карты. Значение может быть roadmap (по умолчанию), satellite или terrain .
  • layer (необязательно): определяет дополнительный слой для отображения на карте, если таковой имеется. Значение может быть одним из следующих: none (по умолчанию), transit , traffic или bicycling .

Примеры карт

Этот пример URL-адреса запускает Карту Google по умолчанию, сосредоточенную на текущем местоположении пользователя.

https://www.google.com/maps/@?api=1&map_action=map

В следующем примере отображается карта с центром в Катумбе, Новый Южный Уэльс, Австралия (по адресу -33.712206,150.311941 ), и задаются дополнительные параметры zoom и basemap .

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain


Отображение панорамы просмотра улиц

Действие «Панорама» позволяет запустить программу просмотра для отображения изображений Street View в виде интерактивных панорам. Каждая панорама Просмотра улиц обеспечивает полный 360-градусный обзор из одного места. Изображения содержат 360 градусов обзора по горизонтали (полный цикл) и 180 градусов обзора по вертикали (от прямо вверх до прямо вниз). Действие pano запускает средство просмотра, которое визуализирует результирующую панораму в виде сферы с камерой в центре. Вы можете манипулировать камерой, чтобы управлять масштабированием и ориентацией камеры.

Google Street View обеспечивает панорамный вид из определенных мест по всей зоне покрытия . Также доступны созданные пользователями специальные коллекции Photospheres и Street View.

Формирование URL просмотра улиц

https://www.google.com/maps/@?api=1&map_action=pano & parameters

Параметры

  • map_action=pano (обязательно): указывает тип отображаемого вида. Карты и Просмотр улиц используют одну и ту же конечную точку. Чтобы обеспечить отображение панорамы, action должно быть указано как pano .

Также требуется один из следующих параметров URL:

  • viewpoint : средство просмотра отображает панораму, сфотографированную ближе всего к местоположению viewpoint , указанную в виде координат широты/долготы, разделенных запятыми (например, 46.414382,10.013988). Поскольку изображения в Просмотре улиц периодически обновляются, а фотографии могут каждый раз делаться с немного разных позиций, возможно, что ваше местоположение может быть привязано к другой панораме при обновлении изображений.
  • pano : конкретный идентификатор панорамы изображения для отображения. Если вы укажете pano , вы также можете указать viewpoint . Точка viewpoint используется только в том случае, если Google Maps не может найти идентификатор панорамы. Если pano указана, но не найдена, а viewpoint НЕ указана, изображение панорамы не отображается. Вместо этого Карты Google открываются в режиме по умолчанию, отображая карту, сосредоточенную на текущем местоположении пользователя.

Следующие параметры URL являются необязательными:

  • heading : Указывает направление камеры по компасу в градусах по часовой стрелке от севера. Допустимые значения от -180 до 360 градусов. Если он опущен, заголовок по умолчанию выбирается на основе точки зрения (если она указана) запроса и фактического местоположения изображения.
  • pitch : определяет угол наклона камеры вверх или вниз. Шаг указывается в градусах от -90 до 90. Положительные значения будут наклонять камеру вверх, а отрицательные значения будут наклонять камеру вниз. Шаг по умолчанию, равный 0, устанавливается в зависимости от положения камеры в момент захвата изображения. Из-за этого шаг 0 часто, но не всегда, является горизонтальным. Например, изображение, снятое на холме, скорее всего, будет иметь шаг по умолчанию, который не является горизонтальным.
  • fov : определяет горизонтальное поле зрения изображения. Поле зрения выражается в градусах в диапазоне от 10 до 100. По умолчанию оно равно 90. При работе с окном просмотра фиксированного размера поле зрения считается уровнем масштабирования, а меньшие числа указывают на более высокий уровень масштабирования. .

Примеры Просмотра улиц

Первые два примера отображают панораму Эйфелевой башни. В первом примере для определения местоположения используется только viewpoint и устанавливаются необязательные параметры heading , pitch и fov . Для сравнения, во втором примере используется идентификатор pano , а также те же параметры, что и в первом примере. В третьем примере отображается панорамное изображение помещения.

Пример 1. Для указания местоположения используется только viewpoint .

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

Пример 2: использует идентификатор pano , а также местоположение viewpoint . Идентификатор pano имеет приоритет над viewpoint . В этом примере идентификатор панорамы найден, поэтому viewpoint игнорируется. Обратите внимание, что панорамное изображение, отображаемое для идентификатора pano , немного отличается и является более новым, чем изображение, найденное с использованием только viewpoint .

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

Пример 3: Отображает панораму интерьера ресторана Sarastro в Лондоне, Великобритания, указанную с идентификатором панорамы.

https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA

Идентификатор панорамы

Чтобы найти идентификатор конкретного изображения панорамы, вы можете использовать несколько методов.

Другие примеры

Примеры маршрутов с использованием путевых точек

Следующие примеры маршрутов запускают Карты Google и отображают маршруты проезда из Парижа, Франция в Шербур, Франция, маршрут через следующие путевые точки:

Столица Укажите имя Идентификатор места
1. Версаль, Франция Версальский дворец ЧIJdUyx15R95kcRj85ZX8H8OAU
2. Шартр, Франция Шартрский собор CHIJKzGHdEgM5EcR_OBTT3nQoEA
3. Ле-Ман, Франция Собор Святого Джулиана Ле-Мана ChIJG2LvQNCI4kcRKXNoAsPi1Mc
4. Кан, Франция Канский замок CHIJ06tnGbxCCkgRsfNjEQMwUsc

В примерах URL путевые точки определены по-разному, поэтому вы можете сравнить различия в отображении путевых точек на полученных картах.

Пример 1: путевые точки, определенные как город, страна:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

Пример 2: путевые точки, определенные как конкретные названия мест:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

Пример 3: Путевые точки определены как Город, Страна, а также указаны waypoint_place_ids для конкретного заведения в каждой путевой точке:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

Пример 4: Определяет путевые точки как Город, Страна, но перечисляет путевые точки в другом порядке по сравнению с предыдущими примерами. Демонстрирует, что карта отображает путевые точки в том порядке, в котором они перечислены в URL-адресе.

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

Примеры карт

Отображает карту с указанной basemap (спутник) и layer (транзит).

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

Примеры Просмотра улиц

Отображает панораму просмотра улиц с использованием ключа изображения FIFE в качестве идентификатора pano . Обратите внимание, что идентификатор pano начинается с F: .

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55