Запуск приложения "Карты 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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