실내 지도 wayfinding 서비스(미리 보기)

Azure Maps Creator wayfinding 서비스를 사용하면 실내 지도 내의 모든 위치로 이동할 수 있습니다. 이 서비스는 계단과 엘리베이터를 활용하여 층 사이를 이동하며 물리적 장애물을 탐색하는 데 도움이 되는 지침을 제공합니다. 이 문서에서는 샘플 실내 맵에서 시작점에서 대상 지점으로 경로를 생성하는 방법을 설명합니다.

필수 조건

• Creator 개념에 대한 이해
• Azure Maps Creator 데이터 세트 및 타일 세트.

routeset 만들기

routeset은 wayfinding 서비스에서 사용하는 실내 지도 데이터의 컬렉션입니다.

경로 집합은 데이터 세트에서 만들어집니다. 경로 집합은 데이터 세트와 독립적입니다. 즉, 데이터 세트가 삭제되어도 경로 집합은 계속 존재합니다.

routeset을 만든 후에는 wayfinding API를 사용하여 시작점에서 시설 내의 대상 지점까지 경로를 가져올 수 있습니다.

routeset 만들기

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 키의 값을 복사합니다.

Operation-Location 키는 다음 섹션에서 설명한 대로 경로 집합 만들기의 상태를 확인하는 데 사용되는 상태 URL입니다.

routeset 만들기 상태를 확인하고 routesetId를 검색합니다.

routeset 만들기 프로세스의 상태를 확인하고 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} 
   
   

   참고 항목

   새 routeset을 만들 때 응답 헤더의 Operation-Location 키에서 operationId을(를) 가져옵니다.

2. 응답 헤더에서 Resource-Location 키의 값을 복사합니다. 리소스 위치 URL이며 routesetId를 포함합니다.

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

routesetId을 기록해 둡니다. 모든 wayfinding 요청과 시설 ID를 가져올 때 필요합니다.

시설 ID 가져오기

routeset의 속성인 facilityId은(는) wayfinding 경로를 검색할 때 필요한 매개 변수입니다. routeset을 쿼리하여 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은(는) 다음 예제의 FCL43인 routeset 요청의 응답 본문에서 찾을 수 있는 facilityDetails 개체의 속성입니다.

{
    "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"
}

wayfinding 경로 가져오기

wayfinding API를 사용하여 이전 섹션에서 만든 경로 집합에서 경로를 생성합니다. wayfinding API에는 실내 맵의 시작 및 끝점과 층 수가 포함된 쿼리가 필요합니다. Creator wayfinding에 대한 자세한 내용은 개념 문서의 wayfinding 을 참조하세요.

wayfinding 쿼리를 만들려면 다음을 수행합니다.

1. 다음 HTTP GET 요청을 실행합니다. 여기서 {routesetId}를 routeset 만들기 상태 확인 섹션에서 가져온 routesetId로 바꾸고 {facilityId}를 시설 ID 가져오기 섹션에서 얻은 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 매개 변수를 사용하여 엘리베이터 또는 계단 등 경로를 결정할 때 wayfinding 서비스가 피할 항목을 지정할 수 있습니다.

2. 경로 및 다리의 세부 정보는 응답 본문에 표시됩니다.

요약은 총 여정의 예상 이동 시간(초)을 표시합니다. 또한 여정 각 구간의 예상 시간은 각 다리의 시작 부분에 표시됩니다.

wayfinding 서비스는 특정 중간 지점을 통해 경로를 계산합니다. 각 지점은 위도 및 경도 세부 정보와 함께 표시됩니다.