Служба сопоставления помещений (предварительная версия)
Служба azure Карты Creator wayfinding позволяет перемещаться из места в любое место в пределах вашей внутренней карты. Служба использует лестницу и лифты для перехода между этажами и предоставляет рекомендации, чтобы помочь вам перемещаться по физическим препятствиям. В этой статье описывается, как создать путь от начальной точки к конечной точке в образце схемы помещений.
Необходимые компоненты
- Понимание концепций Создателя.
- Набор данных и набор плиток в Azure Карты Creator. Если вы никогда не использовали Azure Карты Creator для создания крытый карты, вы можете найти создателя, чтобы создать учебник по картам помещений.
Важно!
- В этой статье используется географический URL-адрес
us.atlas.microsoft.com
. Если ваша служба Создателя была создана за пределами США, используйте другой географический URL-адрес. Дополнительные сведения см. в разделе "Доступ к службам Creator". - В примерах URL-адресов в этой статье вам потребуется:
- Замените
{Your-Azure-Maps-Subscription-key}
ключ подписки azure Карты. - Замените
{datasetId
} вашимdatasetId
. Дополнительные сведения см. в разделе "Проверка состояния создания набора данных" руководства по созданию карт помещений с помощью Создателя.
- Замените
Создание набора маршрутов
Набор маршрутов — это коллекция данных карты помещений, используемых службой определения пути.
Набор маршрутов создается из набора данных. Набор маршрутов не зависит от набора данных, то есть, если набор данных удаляется, набор маршрутов продолжает существовать.
После создания набора маршрутов можно использовать API-интерфейс управления путем, чтобы получить путь от начальной точки до конечной точки в объекте.
Чтобы создать набор маршрутов, выполните приведенные ниже действия.
Выполните следующий HTTP-запрос POST:
https://us.atlas.microsoft.com/routesets?api-version=2023-03-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Subscription-key}
Скопируйте значение ключа Operation-Location из заголовка ответа.
Ключ "Расположение операции" — это URL-адрес состояния, используемый для проверка состояния создания набора маршрутов, как показано в следующем разделе.
Проверьте состояние создания набора маршрутов и получите идентификатор routesetId
Чтобы проверка состояние процесса создания набора маршрутов и получить идентификатор routesetId:
Выполните следующий 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 в заголовке ответа при создании нового набора маршрутов.Скопируйте значение ключа Resource-Location из заголовка ответов. Это URL-адрес расположения ресурса и содержит следующее
routesetId
:
Запишите routesetId
. Это необходимо во всех способах определений запросов и при получении идентификатора объекта.
Получение идентификатора объекта
Свойство facilityId
набора маршрутов является обязательным параметром при поиске пути. Получите, facilityId
запросив набор маршрутов.
Выполните следующий HTTP-запрос GET:
https://us.atlas.microsoft.com/routesets/{routesetId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}
Это
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 задания пути требуется запрос, содержащий начальные и конечные точки в схеме помещений, а также порядковые номера уровня пола. Дополнительные сведения о определение пути создателя см. в статье о принципах.
Чтобы создать путь к определенному запросу, выполните приведенные далее действия.
Выполните следующий 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
параметр можно использовать для указания чего-либо для службы определения пути, чтобы избежать при определении пути, например лифтов или лестниц.Сведения о пути и ногах отображаются в тексте ответа.
В сводке отображается предполагаемое время путешествия в секундах для общего пути. Кроме того, предполагаемое время для каждого раздела пути отображается в начале каждой ноги.
Служба определения пути вычисляет путь через определенные промежуточные точки. Отображается каждая точка, а также сведения о широте и долготе.