Servizio di orientamento per Indoor Maps (anteprima)

Articolo
09/27/2024

Nota

Ritiro di Creator di Mappe di Azure

Il servizio per la creazione di piante dell'interno Creator di Mappe di Azure è ora deprecato e verrà ritirato il 30/09/25. Per altre informazioni, vedere Annuncio di fine vita di Creator di Mappe di Azure.

Il servizio di orientamento di Creator di Mappe di Azure consente di spostarsi da un punto all'altro all'interno della mappa interna. Il servizio utilizza scale e ascensori per spostarsi tra piani e fornisce indicazioni per spostarsi tra ostacoli fisici. Questo articolo descrive come generare un percorso da un punto di partenza a un punto di destinazione in una mappa interna di esempio.

Prerequisiti

Comprendere ii concetti di Creator.
Set di dati e set di tessere di Creator di Mappe di Azure.

Importante

Questo articolo usa l'URL geografico us.atlas.microsoft.com. Se il servizio Creator non è stato creato negli Stati Uniti, è necessario usare un URL geografico diverso. Per altre informazioni, vedere Accesso ai servizi Creator.
Negli URL di esempio contenuti in questo articolo è necessario:
- Sostituire {Your-Azure-Maps-Subscription-key} con la chiave di sottoscrizione di Mappe di Azure.
- Sostituire {datasetId} con datasetId.

Creare un set di route

Un set di route è una raccolta di dati della mappa di interni usati dal servizio di orientamento.

Un set di route viene creato da un set di dati. Il set di route è indipendente dal set di dati, ovvero se il set di dati viene eliminato, il set di route continua a esistere.

Dopo aver creato un set di route, è possibile usare l'API di orientamento per ottenere un percorso dal punto di partenza al punto di destinazione all'interno della struttura.

Per creare un set di route:

Eseguire la richiesta HTTP POST seguente:

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

Copiare il valore della chiave Operation-Location dall'intestazione della risposta.

La chiave Operation-Location è l'URL di stato usato per controllare lo stato della creazione del set di route, come illustrato nella sezione successiva.

Controllare lo stato di creazione del set di route e recuperare il routeetId

Per controllare lo stato del processo di creazione del set di route e recuperare routeetId:

Eseguire la richiesta HTTP GET seguente:
```
https://us.atlas.microsoft.com/routesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key} 
```
Nota

Ottenere operationId dalla chiave Operation-Location nell'intestazione della risposta durante la creazione di un nuovo set di route.
Copiare il valore della chiave Resource-Location dall'intestazione delle risposte. Si tratta dell'URL della posizione della risorsa e contiene routesetId:

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

Prendere nota di routesetId. È necessario in tutte le richieste di orientamento definizione e quando si ottiene l'ID della struttura.

Ottenere l'ID della struttura

facilityId, una proprietà del set di route, è un parametro obbligatorio durante la ricerca di un percorso di orientamento. Ottenere facilityId eseguendo una query sul set di route.

Eseguire la richiesta HTTP GET seguente:

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

facilityId è una proprietà dell'oggetto facilityDetails, che è possibile trovare nel corpo della risposta della richiesta del set di route, nell'esempio FCL43 seguente:

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

Ottenere un percorso di orientamento

Usare l'API orientamento per generare un percorso dal set di route creato nella sezione precedente. L'API di orientamento richiede una query che contiene i punti di inizio e di fine in una mappa interna, insieme ai numeri ordinali a livello di piano. Per altre informazioni sull'orientamento di Creator, vedere orientamento nell'articolo sui concetti.

Per creare una query di orientamento:

Eseguire la richiesta HTTP GET seguente (sostituire {routesetId} con il routeetId ottenuto nella sezione Controllare lo stato di creazione del set di route e {facilityId} con il facilityId ottenuto nella sezione Ottenere l'ID struttura):
```
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}
```
Suggerimento

È possibile usare il parametro AvoidFeatures per specificare un elemento per il servizio di definizione del percorso da evitare quando si determina il percorso, ad esempio ascensori o scale.
I dettagli del percorso e delle gambe vengono visualizzati nel corpo della risposta.

Il riepilogo visualizza il tempo di viaggio stimato in secondi per il viaggio totale. Inoltre, il tempo stimato per ogni sezione del viaggio viene visualizzato all'inizio di ogni gamba.

Il servizio di orientamento calcola il percorso attraverso punti intermedi specifici. Ogni punto viene visualizzato, insieme ai dettagli relativi alla latitudine e alla longitudine.

Condividi tramite