Начало работы

Введение

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

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

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

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

  • На устройстве Android:
    • Если приложение Google Maps для Android установлено и активно, URL-адрес запускает Google Maps в приложении «Карты» и выполняет запрошенное действие.
    • Если приложение Google Maps не установлено или отключено, URL-адрес запускает Google Maps в браузере и выполняет запрошенное действие.
  • На устройстве iOS:
    • Если установлено приложение Google Maps для iOS , URL-адрес запускает Google 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-адреса.

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

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

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

Доступны следующие действия с картой: поиск, направление, отображение карты и отображение панорамы Street View. Вы указываете действие в 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 не смогут найти идентификатор места. Если вы пытаетесь установить ссылку на конкретное заведение, идентификатор места — лучшая гарантия того, что вы попадете в нужное место. Также рекомендуется отправлять 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 пытаются найти объекты рядом с вашим текущим местоположением. Если вы предпочитаете указать местоположение для категориального поиска, включите это местоположение в общую строку поиска (например, pizza+seattle+wa ).

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

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

Направления

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

Формирование 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 .

    Примечание. Этот параметр является необязательным, если только вы не укажете в URL-адресе destination_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 .
  • avoid (необязательно): устанавливает функции, которые маршрут должен избегать. Можно установить один или несколько из этих параметров, разделенных запятой " , " ( URL-адрес закодирован как %2C ):
    • ferries
    • highways
    • tolls

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

Следующий 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

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

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 не могут найти идентификатор панорамы. Если 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. Версаль, Франция Версальский дворец ChIJdUyx15R95kcRj85ZX8H8OAU
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

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

Отображает панораму Street View, используя ключ изображения 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