Share via


Esercitazione: Usare Mappe di Azure Creator per creare mappe di interni

Questa esercitazione descrive come creare mappe di interni da usare in Microsoft Mappe di Azure. Questa esercitazione illustra come:

  • Caricare il pacchetto di disegno per le mappe interne.
  • Convertire il pacchetto di disegno in dati mappa.
  • Creare un set di dati dai dati della mappa.
  • Creare un set di tessere dai dati nel set di dati.
  • Ottenere l'ID di configurazione della mappa predefinito dal set di tessere.

È anche possibile creare un set di dati da un pacchetto GeoJSON. Per altre informazioni, vedere Creare un set di dati usando un pacchetto GeoJSON (anteprima).

Prerequisiti

Questa esercitazione usa l'applicazione Postman , ma è possibile usare un ambiente di sviluppo delle API diverso.

Importante

  • Questo articolo usa l'URL us.atlas.microsoft.com geografico. Se il servizio Creator non è stato creato nella Stati Uniti, è necessario usare un URL geografico diverso. Per altre informazioni, vedere Accesso ai servizi creatore.
  • Negli esempi di URL sostituire {Your-Azure-Maps-Subscription-key} con la chiave di sottoscrizione Mappe di Azure.

Caricare un pacchetto di disegno

Seguire la procedura descritta nell'articolo Come creare il registro dati per caricare il pacchetto GeoJSON nell'account di archiviazione di Azure e quindi registrarlo nell'account di Mappe di Azure.

Importante

Assicurarsi di prendere nota del valore di identificatore univoco (udid) necessario. udid è il modo in cui si fa riferimento al pacchetto GeoJSON caricato nell'account di archiviazione di Azure dal codice sorgente e dalle richieste HTTP.

Convertire un pacchetto di disegno

Ora che il pacchetto di disegno viene caricato, usare il udid valore per il pacchetto caricato per convertire il pacchetto in dati della mappa. L'API di conversione usa una transazione a esecuzione prolungata che implementa il modello definito nell'articolo Operazione creatore a esecuzione prolungata.

Per convertire un pacchetto di disegno:

  1. Nell'app Postman selezionare Nuovo.

  2. Nella finestra Crea nuovo selezionare Richiesta HTTP.

  3. In Nome richiesta immettere un nome per la richiesta, ad esempio POST Convert Drawing Package.

  4. Selezionare il metodo HTTP POST .

  5. Immettere l'URL seguente per il servizio di conversione. Sostituire {Your-Azure-Maps-Subscription-key} con la chiave di sottoscrizione Mappe di Azure. Sostituire udid con il udid valore del pacchetto caricato.

    https://us.atlas.microsoft.com/conversions?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2023-03-01-preview&udid={udid}&inputType=DWG&dwgPackageVersion=2.0
    
  6. Selezionare Invia.

  7. Nella finestra della risposta selezionare la scheda Intestazioni .

  8. Copiare il valore della chiave Operation-Location . Contiene l'URL di stato usato per controllare lo stato della conversione.

    Screenshot of Postman that shows the URL value of the operation location key in the response header.

Controllare lo stato della conversione del pacchetto di disegno

Al termine dell'operazione di conversione, restituisce un conversionId valore. È possibile accedere al conversionId valore controllando lo stato del processo di conversione del pacchetto di disegno. È quindi possibile usare il conversionId valore per accedere ai dati convertiti.

Per controllare lo stato del processo di conversione e recuperare il conversionId valore:

  1. Nell'app Postman selezionare Nuovo.

  2. Nella finestra Crea nuovo selezionare Richiesta HTTP.

  3. In Nome richiesta immettere un nome per la richiesta, ad esempio GET Conversion Status.

  4. Selezionare il metodo HTTP GET .

  5. Immettere l'URL di stato copiato nella sezione Converti un pacchetto di disegno. La richiesta deve essere simile all'URL seguente:

    https://us.atlas.microsoft.com/conversions/operations/{operationId}?api-version=2.0&subscription-key={Your-Azure-Maps-Subscription-key}
    
  6. Selezionare Invia.

  7. Nella finestra della risposta selezionare la scheda Intestazioni .

  8. Copiare il valore della chiave Resource-Location , ovvero l'URL della posizione della risorsa. L'URL della posizione della risorsa contiene l'identificatore univoco conversionId, che altre API usano per accedere ai dati della mappa convertiti.

    Screenshot of Postman that highlights the conversion ID value that appears in the Resource-Location key in the response header.

Il pacchetto di disegno di esempio deve essere convertito senza errori o avvisi. Tuttavia, se si ricevono errori o avvisi dal proprio pacchetto di disegno, la risposta JSON include un collegamento al visualizzatore errori di disegno. È possibile utilizzare il visualizzatore errori di disegno per esaminare i dettagli degli errori e degli avvisi. Per ottenere consigli per la risoluzione degli errori di conversione e degli avvisi, vedere Disegno di errori di conversione e avvisi.

Il frammento JSON seguente visualizza un avviso di conversione di esempio:

{
    "operationId": "{operationId}",
    "created": "2021-05-19T18:24:28.7922905+00:00",
    "status": "Succeeded",
     "warning": {
        "code": "dwgConversionProblem",
        "details": [
            {
                "code": "warning",
                "details": [
                    {
                        "code": "manifestWarning",
                        "message": "Ignoring unexpected JSON property: unitProperties[0].nonWheelchairAccessible with value False"
                    }
                ]
            }
        ]
    },
    "properties": {
        "diagnosticPackageLocation": "https://atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=1.0"
    }
}

Creare un set di dati

Un set di dati è una raccolta di caratteristiche della mappa, ad esempio edifici, livelli e stanze. Per creare un set di dati, usare l'API Dataset Create. L'API Di creazione set di dati accetta il conversionId valore per il pacchetto di disegno convertito e restituisce un datasetId valore per il set di dati creato.

Per creare un set di dati:

  1. Nell'app Postman selezionare Nuovo.

  2. Nella finestra Crea nuovo selezionare Richiesta HTTP.

  3. In Nome richiesta immettere un nome per la richiesta, ad esempio POST Dataset Create( Crea set di dati POST).

  4. Selezionare il metodo HTTP POST .

  5. Immettere l'URL seguente per il servizio Set di dati. Sostituire {conversionId} con il conversionId valore ottenuto in Controllare lo stato della conversione del pacchetto di disegno.

    https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&conversionId={conversionId}&subscription-key={Your-Azure-Maps-Subscription-key}
    
  6. Selezionare Invia.

  7. Nella finestra della risposta selezionare la scheda Intestazioni .

  8. Copiare il valore della chiave Operation-Location . Contiene l'URL di stato usato per controllare lo stato del set di dati.

    Screenshot of Postman that shows the value of the Operation-Location key for a dataset in the response header.

Controllare lo stato di creazione del set di dati

Per controllare lo stato del processo di creazione del set di dati e recuperare il datasetId valore:

  1. Nell'app Postman selezionare Nuovo.

  2. Nella finestra Crea nuovo selezionare Richiesta HTTP.

  3. Per Request name (Nome richiesta) immettere un nome per la richiesta, ad esempio GET Dataset Status (Stato set di dati GET).

  4. Selezionare il metodo HTTP GET .

  5. Immettere l'URL di stato copiato nella sezione Creare un set di dati . La richiesta deve essere simile all'URL seguente:

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

  7. Nella finestra della risposta selezionare la scheda Intestazioni . Il valore della chiave Resource-Location è l'URL della posizione della risorsa. L'URL della posizione della risorsa contiene l'identificatore univoco (datasetId) del set di dati.

  8. Salvare il datasetId valore perché verrà usato nell'esercitazione successiva.

    Screenshot of Postman that shows the dataset ID value of the Resource-Location key in the response header.

Creare un set di tessere

Un set di tessere è un set di tessere vettoriali che esegue il rendering sulla mappa. I set di tessere vengono creati da set di dati esistenti. Tuttavia, un set di riquadri è indipendente dal set di dati da cui proviene. Se il set di dati viene eliminato, il set di tessere continua a esistere.

Per creare un set di riquadri:

  1. Nell'app Postman selezionare Nuovo.

  2. Nella finestra Crea nuovo selezionare Richiesta HTTP.

  3. In Nome richiesta immettere un nome per la richiesta, ad esempio POST Tileset Create.

  4. Selezionare il metodo HTTP POST .

  5. Immettere l'URL seguente per il servizio Tileset. Sostituire {datasetId} con il datasetId valore ottenuto nella sezione Controllare lo stato della creazione del set di dati.

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

  7. Nella finestra della risposta selezionare la scheda Intestazioni .

  8. Copiare il valore della chiave Operation-Location . Contiene l'URL di stato usato per controllare lo stato del set di riquadri.

    Screenshot of Postman that shows the status URL, which is the value of the Operation-Location key in the response header.

Controllare lo stato della creazione del set di riquadri

Per controllare lo stato del processo di creazione del set di riquadri e recuperare il tilesetId valore:

  1. Nell'app Postman selezionare Nuovo.

  2. Nella finestra Crea nuovo selezionare Richiesta HTTP.

  3. In Nome richiesta immettere un nome per la richiesta, ad esempio GET Tileset Status.

  4. Selezionare il metodo HTTP GET .

  5. Immettere l'URL di stato copiato nella sezione Creare un set di riquadri . La richiesta deve essere simile all'URL seguente:

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

  7. Nella finestra della risposta selezionare la scheda Intestazioni . Il valore della chiave Resource-Location è l'URL della posizione della risorsa. L'URL della posizione della risorsa contiene l'identificatore univoco (tilesetId) del set di dati.

    Screenshot of Postman that shows the tileset ID, which is part of the value of the resource location URL in the response header.

Ottenere la configurazione della mappa (anteprima)

Dopo aver creato un set di riquadri, è possibile ottenere il mapConfigurationId valore usando il set di tessere ottenere la richiesta HTTP:

  1. Nell'app Postman selezionare Nuovo.

  2. Nella finestra Crea nuovo selezionare Richiesta HTTP.

  3. In Nome richiesta immettere un nome per la richiesta, ad esempio GET mapConfigurationId from Tileset.

  4. Selezionare il metodo HTTP GET .

  5. Immettere l'URL seguente per il servizio Tileset. Passare l'ID del set di tessere ottenuto nel passaggio precedente.

    https://us.atlas.microsoft.com/tilesets/{tilesetId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}
    
  6. Selezionare Invia.

  7. Il file JSON del set di riquadri viene visualizzato nel corpo della risposta. Scorrere verso il basso per visualizzare il mapConfigurationId valore:

    "defaultMapConfigurationId": "5906cd57-2dba-389b-3313-ce6b549d4396"
    

Per altre informazioni, vedere Configurazione della mappa nell'articolo sui concetti relativi alle mappe di interni.

Passaggi successivi