Служба сопоставления помещений (предварительная версия)

  • Статья

Служба azure Карты Creator wayfinding позволяет перемещаться из места в любое место в пределах вашей внутренней карты. Служба использует лестницу и лифты для перехода между этажами и предоставляет рекомендации, чтобы помочь вам перемещаться по физическим препятствиям. В этой статье описывается, как создать путь от начальной точки к конечной точке в образце схемы помещений.

Необходимые компоненты

Важно!

  • В этой статье используется географический URL-адрес us.atlas.microsoft.com. Если ваша служба Создателя была создана за пределами США, используйте другой географический URL-адрес. Дополнительные сведения см. в разделе "Доступ к службам Creator".
  • В примерах URL-адресов в этой статье вам потребуется:
    • Замените {Your-Azure-Maps-Subscription-key} ключ подписки azure Карты.
    • Замените {datasetId} вашим datasetId. Дополнительные сведения см. в разделе "Проверка состояния создания набора данных" руководства по созданию карт помещений с помощью Создателя.

Создание набора маршрутов

Набор маршрутов — это коллекция данных карты помещений, используемых службой определения пути.

Набор маршрутов создается из набора данных. Набор маршрутов не зависит от набора данных, то есть, если набор данных удаляется, набор маршрутов продолжает существовать.

После создания набора маршрутов можно использовать API-интерфейс управления путем, чтобы получить путь от начальной точки до конечной точки в объекте.

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

  1. Выполните следующий HTTP-запрос POST:

    https://us.atlas.microsoft.com/routesets?api-version=2023-03-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Subscription-key}

  2. Скопируйте значение ключа Operation-Location из заголовка ответа.

Ключ "Расположение операции" — это URL-адрес состояния, используемый для проверка состояния создания набора маршрутов, как показано в следующем разделе.

Проверьте состояние создания набора маршрутов и получите идентификатор routesetId

Чтобы проверка состояние процесса создания набора маршрутов и получить идентификатор routesetId:

  1. Выполните следующий HTTP-запрос GET:

    https://us.atlas.microsoft.com/routesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

    Примечание.

    operationId Получите из ключа Operation-Location в заголовке ответа при создании нового набора маршрутов.

  2. Скопируйте значение ключа Resource-Location из заголовка ответов. Это URL-адрес расположения ресурса и содержит следующее routesetId:

    https://us.atlas.microsoft.com/routesets/**675ce646-f405-03be-302e-0d22bcfe17e8**?api-version=2023-03-01-preview

Запишите routesetId. Это необходимо во всех способах определений запросов и при получении идентификатора объекта.

Получение идентификатора объекта

Свойство facilityIdнабора маршрутов является обязательным параметром при поиске пути. Получите, facilityId запросив набор маршрутов.

  1. Выполните следующий HTTP-запрос GET:

    https://us.atlas.microsoft.com/routesets/{routesetId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

  2. Это facilityId свойство facilityDetails объекта, которое можно найти в тексте ответа запроса набора маршрутов, который находится FCL43 в следующем примере:

{
    "routeSetId": "675ce646-f405-03be-302e-0d22bcfe17e8",
    "dataSetId": "eec3825c-620f-13e1-b469-85d2767c8a41",
    "created": "10/10/2022 6:58:32 PM +00:00",
    "facilityDetails": [
        {
            "facilityId": "FCL43",
            "levelOrdinals": [
                0,
                1
            ]
        }
    ],
    "creationMode": "Wall",
    "ontology": "facility-2.0"
}

Получение пути, заданного путем

Используйте API- определение пути для создания пути из набора маршрутов, созданного в предыдущем разделе. Для api задания пути требуется запрос, содержащий начальные и конечные точки в схеме помещений, а также порядковые номера уровня пола. Дополнительные сведения о определение пути создателя см. в статье о принципах.

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

  1. Выполните следующий HTTP-запрос GET (замените {routesetId} на routesetId, полученный в разделе "Проверка состояния создания набора маршрутов" и {facilityId} с идентификатором объекта, полученным в разделе "Получить идентификатор объекта").

    https://us.atlas.microsoft.com/wayfinding/path?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}&routesetid={routeset-ID}&facilityid={facility-ID}&fromPoint={lat,lon}&fromLevel={from-level}&toPoint={lat,lon}&toLevel={to-level}&minWidth={minimun-width}

    Совет

    Этот AvoidFeatures параметр можно использовать для указания чего-либо для службы определения пути, чтобы избежать при определении пути, например лифтов или лестниц.

  2. Сведения о пути и ногах отображаются в тексте ответа.

В сводке отображается предполагаемое время путешествия в секундах для общего пути. Кроме того, предполагаемое время для каждого раздела пути отображается в начале каждой ноги.

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