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

Статья
01/10/2024

Узнайте, как запустить приложение Карты 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>

a map centered over new york city.

Ниже приведено описание схемы 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:?	Открывает приложение Карты.
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: справочник по параметрам.

an example of directions

Пример 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 запускаются, приложение Карты будет проверка, чтобы узнать, было ли устройство когда-либо исправлено расположение GPS. Если он имеется, приложение Карты будет переходить к повернутые направления. Если это не так, приложение отобразит обзор маршрута, как описано в направлениях отображения и трафике.

an example of turn-by-turn directions

Пример 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 = ["-"] 13DIGIT [". 17DIGIT] degreeslon = ["-"] 12DIGIT [". 17DIGIT] Пример: 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 = "sty=" ("a" / "r"/"3d") Пример: sty=a	Определяет стиль карты. Допустимые значения для этого параметра: a. Отображение воздушного представления карты. r: отображение представления дороги карты. 3d: отображение трехмерного представления карты. Используйте в сочетании с параметром cp и при необходимости с параметром rad . В Windows 10 воздушный вид и трехмерные стили представления одинаковы. Примечание. При пропуске параметра sty возникают те же результаты, что и sty=r.
Rad	Радиус	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) для запуска запроса на пошаговое руководство не требуется кодировать и имеет следующий формат.