Поделиться через


Запуск приложения "Карты Windows"

Узнайте, как запустить приложение Карты Windows из приложения. В этом разделе описываются схемы bingmaps:, ms-drive-to:, ms-walk-to:и ms-settings: универсальные схемы идентификатора ресурса (URI). Используйте эти схемы URI для запуска приложения Карты Windows для определенных карт, направлений и результатов поиска или скачивания Карты Windows автономных карт из приложения "Параметры".

Совет. Чтобы узнать больше о запуске приложения Карты Windows из приложения, скачайте пример карты универсальная платформа Windows (UWP) из репозитория windows-universal-samples на сайте GitHub.

Общие сведения о URI

Схемы URI позволяют открывать приложения, щелкнув гиперссылки (или программными средствами) в приложении. Так же, как вы можете начать новую электронную почту с помощью mailto: или открыть веб-браузер с помощью http:, можно открыть приложение карт Windows с помощью bingmaps:, ms-drive-to:и ms-walk-to:.

  • Bingmaps: URI предоставляет карты для расположений, результатов поиска, направлений и трафика.
  • Универсальный код ресурса (URI) ms-drive-to предоставляет направления вождения по очереди из текущего расположения.
  • Ms-walk-to : URI предоставляет пошаговые маршруты от текущего расположения.

Например, следующий универсальный код ресурса (URI) открывает приложение Карты Windows и отображает карту, центрированную по нью-йорку.

<bingmaps:?cp=40.726966~-74.006076>

карта, центрированная по нью-йоркскому городу.

Ниже приведено описание схемы URI:

bingmaps:?query

В этой схеме URI запрос представляет собой ряд пар имени и значения параметров:

¶m1=value1¶m2=value2 ...

Полный список доступных параметров см. в справочнике по параметрам bingmaps:, ms-drive-to:и ms-walk-to. Далее в этом разделе приведены примеры.

Запуск универсального кода ресурса (URI) из приложения

Чтобы запустить приложение Карты Windows из приложения, вызовите метод LaunchUriAsync с помощью bingmaps:, ms-drive-to:или ms-walk-to: URI. В следующем примере запускается тот же универсальный код ресурса (URI) из предыдущего примера. Дополнительные сведения о запуске приложений с помощью URI см. в разделе "Запуск приложения по умолчанию для URI".

// Center on New York City
var uriNewYork = new Uri(@"bingmaps:?cp=40.726966~-74.006076");

// Launch the Windows Maps app
var launcherOptions = new Windows.System.LauncherOptions();
launcherOptions.TargetApplicationPackageFamilyName = "Microsoft.WindowsMaps_8wekyb3d8bbwe";
var success = await Windows.System.Launcher.LaunchUriAsync(uriNewYork, launcherOptions);

В этом примере класс LauncherOptions используется для обеспечения запуска приложения Карты Windows.

Отображение известных расположений

Существует множество параметров для управления частью карты для отображения. Параметр cp (center point) можно использовать с параметрами rad (radius) или lvl (уровень масштабирования), чтобы отобразить расположение и выбрать, как близко к нему увеличить. При использовании параметра cp можно также указать hdg (заголовок) и пит (шаг), чтобы управлять тем, в каком направлении выглядеть. Другой метод — использовать параметр bb (ограничивающий прямоугольник) для предоставления максимальных координат на юге, востоке, севере и западе области, которую вы хотите показать.

Чтобы управлять типом представления, используйте параметры sty (style) и ss (Streetside). Параметр sty позволяет переключаться между дорожными и воздушными представлениями. Параметр ss помещает карту в представление Streetside. Дополнительные сведения об этих и других параметрах см. в справочнике по параметрам bingmap.

Пример URI Результаты
bingmaps:? Открывает приложение Maps.
bingmaps:?cp=40.726966~-74.006076 Отображает карту, центрированную по нью-йорку.
bingmaps:?cp=40.726966~-74.006076&lvl=10 Отображает карту, центрированную по нью-йорку, с уровнем масштабирования 10.
bingmaps:?bb=39.719_-74.52~41.71_-73.5 Отображает карту Нью-йорка, которая является областью, указанной в аргументе bb .
bingmaps:?bb=39.719_-74.52~41.71_-73.5&cp=47~-122 Отображает карту Нью-йорка, которая является областью, указанной в ограничивающем аргументе поля. Центральная точка для Сиэтла, указанная в аргументе cp, игнорируется, так как указан bb .
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16 Отображает карту с точкой с именем Цезарь Дворец (в Лас-Вегасе) и задает уровень масштабирования до 16.
bingmaps:?collection=point.40.726966_-74.006076_Some%255FBusiness Отображает карту с точкой с именем Some_Business (в Лас-Вегасе).
bingmaps:?cp=40.726966~-74.006076&trfc=1&sty=a Отображает карту нью-йоркского города с движением по стилю и стилем воздушной карты.
bingmaps:?cp=47.6204~-122.3491&sty=3d Отображает трехмерное представление пробела иглы.
bingmaps:?cp=47.6204~-122.3491&sty=3d&rad=200&pit=75&hdg=165 Отображает трехмерное представление пробела с радиусом 200 м, шагом в 75 градусов и заголовком 165 градусов.
bingmaps:?cp=47.6204~-122.3491&ss=1 Отображает представление Streetside пространства иглы.

Отображение результатов поиска.

При поиске мест с помощью параметра q рекомендуется сделать термины как можно более конкретными и использовать cp, bb или где параметры для указания расположения поиска. Если не указать расположение поиска и текущее расположение пользователя недоступно, поиск может не возвращать значимые результаты. Результаты поиска отображаются в наиболее подходящем представлении карты. Дополнительные сведения об этих и других параметрах см. в справочнике по параметрам bingmap.

Пример URI Результаты
bingmaps:?q=1600%20Pennsylvania%20Ave,%20Washington,%20DC Отображает карту и ищет адрес Белого дома в Вашингтоне, округ Колумбия.
bingmaps:?q=coffee&where=Сиэтл Ищет кофе в Сиэтле.
bingmaps:?cp=40.726966~-74.006076&where=New%20York Ищет Нью-йорк возле указанной центральной точки.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&q=pizza Ищет пиццу в указанном ограничивающем поле (то есть в Нью-Йорке).

 

Отображение нескольких точек

Используйте параметр коллекции для отображения настраиваемого набора точек на карте. При наличии нескольких точек отображается список точек. В коллекции может быть до 25 точек, и они перечислены в указанном порядке. Коллекция имеет приоритет над запросами поиска и направления. Дополнительные сведения об этом параметре и других см . в разделе bingmaps: справочник по параметрам.

Пример URI Результаты
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace Ищет Дворец Цезаря в Лас-Вегасе и отображает результаты на карте в лучшем представлении карты.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16 Отображает цезарь с именем Цезарь дворец в Лас-Вегасе и увеличивается до уровня 16.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669 Отображает pushpin с именем Цезарь дворец и отжимок с именем Белладжио в Лас-Вегасе и увеличивается до уровня 16.
bingmaps:?collection=point.40.726966_-74.006076_Fake%255FBusiness%255Fwith%255FUnderscore Отображает Нью-йорк с кнопкой с именем Fake_Business_with_Underscore.
bingmaps:?collection=name. Hotel%20List~point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669 Отображает список с именем "Список отелей" и два толчок для Цезаря Дворца и Беллагио в Лас-Вегасе и увеличивается до уровня 16.

 

Отображение направлений и трафика

Можно отобразить направления между двумя точками с помощью параметра RTP . Эти точки могут быть адресами или координатами широты и долготы. Используйте параметр trfc для отображения сведений о трафике. Чтобы указать тип направлений: вождения, ходьбы или транзита , используйте параметр режима . Если режим не указан, направления будут предоставлены с помощью предпочтительного режима транспорта пользователя. Дополнительные сведения об этих параметрах и других см . в bingmaps: справочник по параметрам.

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

Пример URI Результаты
bingmaps:?rtp=pos.44.9160_-110.4158~pos.45.0475_-109.4187 Отображает карту с направлениями точек к точке. Так как режим не указан, направления будут предоставлены с помощью пользовательского режима транспорта.
bingmaps:?cp=43.0332~-87.9167&trfc=1 Отображает карту, центрированную по милуоки, WI с трафиком.
bingmaps:?rtp=adr. One Microsoft Way, Redmond, WA 98052~pos.39.0731_-108.7238 Отображает карту с указаниями из указанного адреса в указанное расположение.
bingmaps:?rtp=adr.1%20Microsoft%20Way,%20Redmond,%20WA,%2098052~pos.36.1223_-111.9495_Grand%20Canyon%20northern%20rim Отображает направления от 1 Microsoft Way, Редмонд, WA, 98052 до северного края Гранд-Каньона.
bingmaps:?rtp=adr. Davenport, CA~adr. Yosemite Village Отображает карту с направлениями вождения от указанного расположения к указанному ориентиру.
bingmaps:?rtp=adr. Mountain%20View,%20CA~adr. San%20Francisco%20International%20Airport,%20CA&mode=d Отображает направления вождения от Горы Вид, ЦС до Международного аэропорта Сан-Франциско, ЦС.
bingmaps:?rtp=adr. Mountain%20View,%20CA~adr. San%20Francisco%20International%20Airport,%20CA&mode=w Отображает маршруты ходьбы от Горы Вид, ЦС до международного аэропорта Сан-Франциско, ЦС.
bingmaps:?rtp=adr. Mountain%20View,%20CA~adr. San%20Francisco%20International%20Airport,%20CA&mode=t Отображает маршруты транзита от Горы Вид, ЦС до международного аэропорта Сан-Франциско, ЦС.

Отображение по поворотам направлений

Ms-drive-to: и ms-walk-to: схемы URI позволяют запускать непосредственно в представление маршрута путем поворота. Эти схемы URI могут предоставлять только направления из текущего расположения пользователя. Если необходимо указать направления между точками, которые не включают текущее расположение пользователя, используйте схему bingmaps: схему URI, как описано в предыдущем разделе. Дополнительные сведения об этих схемах URI см. в справочнике по параметрам ms-drive-to: и ms-walk-to .

Важно, когда ms-drive-to: или ms-walk-to: схемы URI запускаются, приложение Maps проверяет, было ли устройство когда-либо исправлено расположение GPS. Если он имеется, приложение Maps будет продолжать выполнять повернутые направления. Если это не так, приложение отобразит обзор маршрута, как описано в направлениях отображения и трафике.

пример поворотных направлений

Пример URI Результаты
ms-drive-to:?destination.latitude=47.680504&destination.долгота=-122.328262&destination.name=Green Lake Отображает карту с повернутыми направлениями вождения в Green Lake из текущего расположения.
ms-walk-to:?destination.latitude=47.680504&destination.долгота=-122.328262&destination.name=Green Lake Отображает карту с повернутыми маршрутами к Зеленому озеру из текущего расположения.

Скачивание автономных карт

Схема ms-settings: URI позволяет запускать непосредственно на определенную страницу в приложении "Параметры". Хотя ms-settings: схема URI не запускается в приложении "Карты", она позволяет запускать непосредственно на страницу "Автономные карты" в приложении "Параметры" и отображает диалоговое окно подтверждения для скачивания автономных карт, используемых приложением "Карты". Схема URI принимает точку, указанную широтой и долготой, и автоматически определяет, доступны ли автономные карты для региона, содержащего эту точку. Если широта и долготу, переданные, попадают в несколько регионов загрузки, диалоговое окно подтверждения позволит пользователю выбрать, какой из этих регионов скачать. Если автономные карты недоступны для региона, содержащего этот момент, страница "Автономные карты" в приложении "Параметры" отображается с помощью диалогового окна ошибки.

Пример URI Результаты
ms-settings:maps-downloadmaps?latlong=47.6,-122.3 Открывает приложение "Параметры" на странице "Автономные карты" с диалоговым окном подтверждения, отображающимся для скачивания карт для региона, содержащего указанную точку широты и долготы.

bingmaps: справочник по параметрам

Синтаксис для каждого параметра в этой таблице показан с помощью дополненной backus-Naur Form (ABNF).

Параметр Определение Определение и пример ABNF Сведения

cp

Центральная точка

cp = "cp=" cpval

cpval = degreeslat "~" degreeslon

degreeslat = ["-"] 1*3DIGIT [". 1*7DIGIT]

degreeslon = ["-"] 1*2DIGIT [". 1*7DIGIT]

Пример:

cp=40.726966~-74.006076

Оба значения должны быть выражены в десятичных градусах и разделены тильдой(~).

Допустимые значения долготы : от –180 до +180 включительно.

Допустимые значения широты : от -90 до +90 включительно.

bb

Ограничивающий прямоугольник

bb = "bb=" southlatitude "_" westlongitude "~" northlatitude "_" eastlongitude

southlatitude = degreeslat

northlatitude = degreeslat

westlongitude = degreeslon

eastlongitude = degreeslon

degreeslat = ["-"] 13DIGIT [". 17DIGIT]

degreeslon = ["-"] 12DIGIT [". 17DIGIT]

Пример:

bb=39.719_-74.52~41.71_-73.5

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

Допустимые значения долготы : от –180 до +180 включительно.

Допустимые значения широты : от -90 до +90 включительно.

Параметры cp и lvl игнорируются при предоставлении ограничивающего поля.

where

Расположение

where = "where=" whereval

whereval = 1*( ALPHA/ DIGIT / "-" / "." / "_" / рст-кодированный / "!" / "$" / " / "(" / "*" / "*" / "+" / "," / ":" / "@" / "/" / "?")

Пример:

where=1600%20Pennsylvania%20Ave,%20Washington,%20DC

Термин поиска для определенного расположения, ориентира или места.

к

Термин запроса

q = "q="

Whereval

Пример:

q=мексиканские%20restaurants

Термин поиска для местного бизнеса или категории предприятий.

lvl

Уровень масштаба

lvl = "lvl=" 12DIGIT [". 12DIGIT]

Пример:

lvl=10.50

Определяет уровень масштабирования представления карты. Допустимые значения: 1–20, где 1 масштабируется весь выход.

ячмень

Стиль

sty = "sty=" ("a" / "r"/"3d")

Пример:

sty=a

Определяет стиль карты. Допустимые значения для этого параметра:

  • a. Отображение воздушного представления карты.
  • r: отображение представления дороги карты.
  • 3d: отображение трехмерного представления карты. Используйте в сочетании с параметром cp и при необходимости с параметром rad .

В Windows 10 воздушный вид и трехмерные стили представления одинаковы.

Примечание. При пропуске параметра sty возникают те же результаты, что и sty=r.
 

рад

Радиус

rad = "rad=" 1*8DIGIT

Пример:

rad=1000

Круговая область, указывающая требуемое представление карты. Значение радиуса измеряется в метрах.

яма

Тон

pit = "pit=" поле

Пример:

pit=60

Указывает угол, на котором отображается карта, где 90 смотрит на горизонте (максимум) и 0 смотрит прямо вниз (минимум).

Допустимые значения шага : от 0 до 90 включительно.

hdg

Заголовок

hdg = "hdg=" заголовок

Пример:

hdg=180

Указывает направление карты заголовок в градусах, где 0 или 360 = Север, 90 = Восток, 180 = Юг и 270 = Запад.

ss

Streetside

ss = "ss=" BIT

Пример:

ss=1

Указывает, что при отображении изображения на уровне улицы отображаются ss=1. Пропуск параметра ss приводит к тому же результату, что ss=0и параметр ss. Используйте в сочетании с параметром cp , чтобы указать расположение представления на уровне улицы.

Обратите внимание, что изображения на уровне улицы недоступны во всех регионах.
 

trfc

Трафик

trfc = "trfc=" BIT

Пример:

trfc=1

Указывает, включена ли информация о трафике на карте. Пропуская параметр trfc, выдает те же результаты, что trfc=0и .

Обратите внимание , что данные о трафике недоступны во всех регионах.
 

rtp

Маршрут

rtp = "rtp=" (waypoint "~" [waypoint]) / ("~" waypoint)

waypoint = ("pos"." point) / ("adr"." whereval)

point = "point". pointval ["_" title]

pointval = degreeslat "" degreeslon

degreeslat = ["-"] 13DIGIT [". 17DIGIT]

degreeslon = ["-"] 12DIGIT [". 17DIGIT]

title = whereval

whereval = 1( ALPHA/ DIGIT / "-" / "." / "_" / рст-кодированный / "!" / "$" / " / "(" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")

Примеры:

rtp=adr. Mountain%20View,%20CA~adr. SFO

rtp=adr. One%20Microsoft%20Way,%20Redmond,%20WA~pos.45.23423_-122.1232_My%20Picnic%20Spot

Определяет начало и конец маршрута для рисования на карте, разделенного тильдой (~). Каждая из точек пути определяется позицией с помощью ltitude, долготы и необязательного заголовка или идентификатора адреса.

Полный маршрут содержит ровно две точки пути. Например, маршрут с двумя точками rtp="A"~"B"пути определяется.

Также можно указать неполный маршрут. Например, можно определить только начало маршрута.rtp="A"~ В этом случае входные данные направления отображаются с предоставленной точкой пути в поле From и поле "To " с фокусом.

Если указан только конец маршрута, как и rtp=~"B"в случае, панель направлений отображается с указанной точкой пути в поле "To ". Если доступно точное текущее расположение, текущее расположение предварительно заполнено в поле From с фокусом.

Линия маршрута не рисуется, если задан неполный маршрут.

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

Примечание. Заголовок можно использовать для расположения, если расположение указано значением параметра pos . Вместо отображения широты и долготы будет отображаться название.
 

mode

Режим транспортировки

mode = "mode=" ("d" / "t" / "w")

Пример:

mode=d

Определяет режим транспорта. Допустимые значения для этого параметра:

  • d. Отображает обзор маршрута для направлений вождения
  • t: отображает обзор маршрута для транзитных направлений
  • w: Отображает обзор маршрута для направлений ходьбы

Используйте в сочетании с параметром RTP для направлений транспорта. Если режим не указан, направления будут предоставлены с помощью пользовательского режима транспорта. Режим можно предоставить без параметра маршрута для ввода входных данных направления для этого режима из текущего расположения.

collection

Коллекция

collection = "collection="(name"~"/)point["~"point]

name = "name". Whereval

whereval = 1( ALPHA/ DIGIT / "-" / "." / "_" / рст-кодированный / "!" / "$" / " / "(" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")

point = "point". pointval ["_" title]

pointval = degreeslat "" degreeslon

degreeslat = ["-"] 13DIGIT [". 17DIGIT]

degreeslon = ["-"] 12DIGIT [". 17DIGIT]

title = whereval

Пример:

collection=name. My%20Trip%20Stops~point.36.116584_-115.176753_Las%20Vegas~point.37.8268_-122.4798_Golden%20Gate%20Bridge

Коллекция точек, добавляемых в карту и список. Коллекция точек может быть названа с помощью параметра name. Точка указывается с помощью широты, долготы и необязательного заголовка.

Разделение имен и нескольких точек с тильдами (~).

Если указанный элемент содержит тильду, убедитесь, что тильда закодирован как %7E. Если он не сопровождается параметрами центра и уровня масштабирования, коллекция предоставит лучшее представление карты.

Важно, если указанный элемент содержит символ подчеркивания, убедитесь, что символ подчеркивания закодирован как %255F.

 

ms-drive-to: справочник по параметрам

Универсальный код ресурса (URI) для запуска запроса на повернутые направления вождения не требуется кодировать и имеет следующий формат.

Обратите внимание , что начальная точка в этой схеме URI не указана. Начальная точка всегда предполагается, что это текущее расположение. Если необходимо указать отправную точку, отличное от текущего расположения, см. сведения о направлениях отображения и трафике.

 

Параметр Определение Пример Сведения
destination.latitude Целевая широта Пример: destination.latitude=47.6451413797194 Широта назначения. Допустимые значения широты : от -90 до +90 включительно.
destination.долгота Конечная долгота Пример: destination.долгота=-122.141964733601 Долгота назначения. Допустимые значения долготы : от –180 до +180 включительно.
destination.name Имя назначения Пример: destination.name=Redmond, WA Целевое имя. Не нужно кодировать значение destination.name .

 

ms-walk-to: справочник по параметрам

Универсальный код ресурса (URI) для запуска запроса на пошаговое руководство не требуется кодировать и имеет следующий формат.

Обратите внимание , что начальная точка в этой схеме URI не указана. Начальная точка всегда предполагается, что это текущее расположение. Если необходимо указать отправную точку, отличное от текущего расположения, см. сведения о направлениях отображения и трафике.  

Параметр Определение Пример Сведения
destination.latitude Целевая широта Пример: destination.latitude=47.6451413797194 Широта назначения. Допустимые значения широты : от -90 до +90 включительно.
destination.долгота Конечная долгота Пример: destination.долгота=-122.141964733601 Долгота назначения. Допустимые значения долготы : от –180 до +180 включительно.
destination.name Имя назначения Пример: destination.name=Redmond, WA Целевое имя. Не нужно кодировать значение destination.name .

ms-settings: справочник по параметрам

Синтаксис сопоставления определенных параметров приложения для ms-settings: схема URI определена ниже. Карты-загрузки карт указаны вместе с параметрами ms-settings: URI в виде ms-settings:maps-downloadmaps? , чтобы указать страницу параметров автономных карт. 

Параметр Определение Пример Сведения
latlong Указатель, определяющий автономный регион карты. Пример: latlong=47.6,-122.3 Геоpoint определяется разделенной запятой широтой и долготой. Допустимые значения широты : от -90 до +90 включительно. Допустимые значения долготы : от –180 до +180 включительно.