Usare Creator per creare piante di interniUse Creator to create indoor maps

Questa esercitazione mostra come creare piante di interni.This tutorial shows you how to create indoor maps. Questa esercitazione descrive come usare l'API per:In this tutorial, you'll learn how to use the API to:

  • Caricare il pacchetto di disegno della pianta di interniUpload your indoor map Drawing package
  • Convertire il pacchetto di disegno in dati della piantaConvert your Drawing package into map data
  • Creare un set di dati dai dati della piantaCreate a dataset from your map data
  • Creare un set di tessere a partire dai dati nel set di datiCreate a tileset from the data in your dataset
  • Eseguire una query sull'API Web Feature Service (WFS) di Mappe di Azure per ottenere informazioni sulle funzionalità della piantaQuery the Azure Maps Web Feature Service (WFS) API to learn about your map features
  • Creare un set di stati delle funzionalità usando le funzionalità della pianta e i dati nel set di datiCreate a feature stateset by using your map features and the data in your dataset
  • Aggiornare il set di stati della funzionalitàUpdate your feature stateset

PrerequisitiPrerequisites

Per creare piante di interni è necessario:To create indoor maps:

  1. Creare un account Mappe di AzureMake an Azure Maps account
  2. Ottenere una chiave di sottoscrizione primaria, nota anche come chiave primaria o chiave di sottoscrizioneObtain a primary subscription key, also known as the primary key or the subscription key.
  3. Creare una risorsa CreatorCreate a Creator resource
  4. Scaricare il pacchetto di disegno di esempioDownload the Sample Drawing package.

Questa esercitazione usa l'applicazione Postman, tuttavia è possibile scegliere un ambiente di sviluppo API diverso.This tutorial uses the Postman application, but you may choose a different API development environment.

Importante

Gli URL dell'API in questo documento possono essere modificati in base alla posizione della risorsa dell'autore.The API urls in this document may have to be adjusted according to the location of your Creator resource. Per altri dettagli, vedere accesso ai servizi Creator.For more details, see Access to Creator Services.

Caricare un pacchetto di disegnoUpload a Drawing package

Usare l'API Data Upload per caricare un pacchetto di disegno nelle risorse di Mappe di Azure.Use the Data Upload API to upload the Drawing package to Azure Maps resources.

L'API Data Upload è una transazione a esecuzione prolungata che implementa il modello qui definito.The Data Upload API is a long running transaction that implements the pattern defined here. Al termine dell'operazione, verrà usato udid per accedere al pacchetto caricato e convertirlo.Once the operation completes, we'll use the udid to access the uploaded package to convert it. Seguire questa procedura per ottenere udid.Follow the steps below to obtain the udid.

  1. Aprire l'app Postman.Open the Postman app. Nella parte superiore dell'app Postman selezionare New (Nuovo).Near the top of the Postman app, select New. Nella finestra Create New (Crea nuovo) selezionare Collection (Raccolta).In the Create New window, select Collection. Assegnare un nome alla raccolta e selezionare Create (Crea).Name the collection and select the Create button.

  2. Per creare la richiesta, selezionare nuovamente New (Nuovo).To create the request, select New again. Nella finestra Create New (Crea nuovo) selezionare Request (Richiesta).In the Create New window, select Request. Immettere un Request Name (Nome richiesta) per la richiesta.Enter a Request name for the request. Selezionare la raccolta creata nel passaggio precedente e fare clic su Save (Salva).Select the collection you created in the previous step, and then select Save.

  3. Selezionare il metodo HTTP POST nella scheda del generatore e immettere l'URL seguente per caricare il pacchetto di disegno nel servizio Mappe di Azure.Select the POST HTTP method in the builder tab and enter the following URL to upload the Drawing package to the Azure Maps service. Per questa richiesta, e per altre indicate in questo articolo, sostituire {Azure-Maps-Primary-Subscription-key} con la chiave di sottoscrizione primaria.For this request, and other requests mentioned in this article, replace {Azure-Maps-Primary-Subscription-key} with your primary subscription key.

    https://atlas.microsoft.com/mapData/upload?api-version=1.0&dataFormat=zip&subscription-key={Azure-Maps-Primary-Subscription-key}
    
  4. Nella scheda Headers (Intestazioni) specificare un valore per la chiave Content-Type.In the Headers tab, specify a value for the Content-Type key. Il pacchetto di disegno consiste in una cartella compressa, quindi usare il valore application/octet-stream.The Drawing package is a zipped folder, so use the application/octet-stream value. Nella scheda Body (Corpo) selezionare binary (binario).In the Body tab, select binary. Fare clic su Select File (Seleziona file) e scegliere un pacchetto di disegno.Click on Select File and choose a Drawing package.

    data-management

  5. Fare clic sul pulsante blu Send (Invia) e attendere l'elaborazione della richiesta.Click the blue Send button and wait for the request to process. Al completamento della richiesta, passare alla scheda di risposta Headers (Intestazioni).Once the request completes, go to the Headers tab of the response. Copiare il valore della chiave Location (Posizione), ovvero lo status URL.Copy the value of the Location key, which is the status URL.

  6. Per controllare lo stato della chiamata API, creare una richiesta HTTP Get in status URL .To check the status of the API call, create a GET HTTP request on the status URL. È necessario accodare la chiave di sottoscrizione primaria all'URL per l'autenticazione.You'll need to append your primary subscription key to the URL for authentication. La richiesta Get dovrebbe essere simile all'URL seguente:The GET request should look like the following URL:

    https://atlas.microsoft.com/mapData/operations/<operationId>?api-version=1.0&subscription-key={Azure-Maps-Primary-Subscription-key}
    
  7. Quando la richiesta Get http viene completata correttamente, viene restituito resourceLocation .When the GET HTTP request completes successfully, it will return a resourceLocation. resourceLocationContiene l'oggetto univoco udid per il contenuto caricato.The resourceLocation contains the unique udid for the uploaded content. Facoltativamente, è possibile usare l' resourceLocation URL per recuperare i metadati da questa risorsa nel passaggio successivo.Optionally, you can use the resourceLocation URL to retrieve metadata from this resource in the next step.

    {
        "status": "Succeeded",
        "resourceLocation": "https://atlas.microsoft.com/mapData/metadata/{udid}?api-version=1.0"
    }
    
  8. Per recuperare i metadati del contenuto, creare una richiesta HTTP Get sull' resourceLocation URL recuperato nel passaggio 7.To retrieve content metadata, create a GET HTTP request on the resourceLocation URL that was retrieved in step 7. Assicurarsi di aggiungere la chiave di sottoscrizione primaria all'URL per l'autenticazione.Make sure to append your primary subscription key to the URL for authentication. La richiesta Get dovrebbe essere simile all'URL seguente:The GET request should like the following URL:

    https://atlas.microsoft.com/mapData/metadata/{udid}?api-version=1.0&subscription-key={Azure-Maps-Primary-Subscription-key}
    
  9. Quando la richiesta Get http viene completata correttamente, il corpo della risposta conterrà l' udid oggetto specificato nel resourceLocation passaggio 7, il percorso per accedere/scaricare il contenuto in futuro e altri metadati sul contenuto, ad esempio la data di creazione/aggiornamento, le dimensioni e così via.When the GET HTTP request completes successfully, the response body will contain the udid specified in the resourceLocation of step 7, the location to access/download the content in the future, and some other metadata about the content like created/updated date, size, and so on. Un esempio di risposta complessiva è:An example of the overall response is:

    {
        "udid": "{udid}",
        "location": "https://atlas.microsoft.com/mapData/{udid}?api-version=1.0",
        "created": "2020-02-03T02:32:25.0509366+00:00",
        "updated": "2020-02-11T06:12:13.0309351+00:00",
        "sizeInBytes": 766,
        "uploadStatus": "Completed"
    }
    

Convertire un pacchetto di disegnoConvert a Drawing package

Ora che il pacchetto di disegno è stato caricato, si userà udid per il pacchetto caricato per convertirlo in dati della pianta.Now that the Drawing package is uploaded, we'll use udid for the uploaded package to convert the package into map data. L'API Conversion usa una transazione con esecuzione prolungata, che implementa il modello definito in questo articolo.The Conversion API uses a long running transaction that implements the pattern defined here. Al termine dell'operazione, viene usato conversionId per accedere ai dati convertiti.Once the operation completes, we'll use the conversionId to access the converted data. Seguire questa procedura per ottenere conversionId.Follow the steps below to obtain the conversionId.

  1. Selezionare Nuovo.Select New. Nella finestra Create New (Crea nuovo) selezionare Request (Richiesta).In the Create New window, select Request. Immettere un Request name (Nome richiesta) e selezionare una raccolta.Enter a Request name and select a collection. Fare clic su Salva.Click Save.

  2. Selezionare il metodo HTTP POST nella scheda del generatore e immettere l'URL seguente per convertire il pacchetto di disegno caricato in dati della pianta.Select the POST HTTP method in the builder tab and enter the following URL to convert your uploaded Drawing package into map data. Usare udid per il pacchetto caricato.Use the udid for the uploaded package.

    https://atlas.microsoft.com/conversion/convert?subscription-key={Azure-Maps-Primary-Subscription-key}&api-version=1.0&udid={udid}&inputType=DWG
    

    Importante

    Gli URL dell'API in questo documento possono essere modificati in base alla posizione della risorsa dell'autore.The API urls in this document may have to be adjusted according to the location of your Creator resource. Per altri dettagli, vedere accesso ai servizi Creator.For more details, see Access to Creator Services.

  3. Fare clic su Send (Invia) e attendere l'elaborazione della richiesta.Click the Send button and wait for the request to process. Al completamento della richiesta, passare alla scheda della risposta Headers (Intestazioni) e cercare la chiave Location (Posizione).Once the request completes, go to the Headers tab of the response, and look for the Location key. Copiare il valore della chiave Location (Posizione), che è lo status URL per la richiesta di conversione.Copy the value of the Location key, which is the status URL for the conversion request.

  4. Selezionare il metodo HTTP GET nella scheda del generatore. Accodare la chiave di sottoscrizione primaria di Mappe di Azure allo status URL.Start a new GET HTTP method in the builder tab. Append your Azure Maps primary subscription key to the status URL. Effettuare una richiesta GET per lo status URL ottenuto nel passaggio precedente.Make a GET request at the status URL from the previous step. Se il processo di conversione non è ancora stato completato, è possibile che venga visualizzata una risposta JSON simile alla seguente:If the conversion process hasn't yet completed, you may see something like the following JSON response:

    {
        "operationId": "77dc9262-d3b8-4e32-b65d-74d785b53504",
        "created": "2020-04-22T19:39:54.9518496+00:00",
        "status": "Running"
    }
    
  5. Una volta completata la richiesta, viene visualizzato un messaggio di stato di operazione riuscita nel corpo della risposta.Once the request completes successfully, you'll see a success status message in the response body. Copiare conversionId dall'URL resourceLocation per il pacchetto convertito.Copy the conversionId from the resourceLocation URL for the converted package. conversionId viene usato da altre API per accedere ai dati convertiti della pianta.The conversionId is used by other API to access the converted map data.

    {
        "operationId": "77dc9262-d3b8-4e32-b65d-74d785b53504",
        "created": "2020-04-22T19:39:54.9518496+00:00",
        "status": "Succeeded",
        "resourceLocation": "https://atlas.microsoft.com/conversion/{conversionId}?api-version=1.0",
        "properties": {}
    }
    

Nota

L'applicazione Postman non supporta in modo nativo richieste HTTP con esecuzione prolungata.The Postman application does not natively support HTTP Long Running Requests. Di conseguenza si può notare un lungo ritardo durante l'esecuzione di una richiesta GET nell'URL di stato.As a result, you may notice a long delay while making a GET request at the status URL. Attendere circa trenta secondi e provare a fare clic nuovamente su Send (Invia) fino a quando la risposta non mostra esito positivo o negativo.Wait about thirty seconds and try clicking the Send button again until the response shows success or fail.

Il pacchetto di disegno di esempio deve essere convertito senza errori o avvisi.The sample Drawing package should be converted without errors or warnings. Tuttavia, se si ricevono errori o avvisi dal pacchetto di disegno, la risposta JSON fornirà un collegamento al Drawing error visualizer (Visualizzatore di errori di disegno).However, if you receive errors or warnings from your own Drawing package, the JSON response will give you a link to the Drawing error visualizer. Il Drawing Error visualizer (Visualizzatore di errori di disegno) consente di esaminare i dettagli degli errori e degli avvisi.The Drawing Error visualizer allows you to inspect the details of errors and warnings. Per ricevere consigli su come risolvere gli errori e gli avvisi di conversione, vedere Errori e avvisi di conversione dei disegni.To receive recommendations on how to resolve conversion errors and warnings, see the Drawing conversion errors and warnings.

{
    "operationId": "77dc9262-d3b8-4e32-b65d-74d785b53504",
    "created": "2020-04-22T19:39:54.9518496+00:00",
    "status": "Failed",
    "resourceLocation": "https://atlas.microsoft.com/conversion/{conversionId}?api-version=1.0",
    "properties": {
        "diagnosticPackageLocation": "https://atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=1.0"
    }
}

Creare un set di datiCreate a dataset

Il set di dati è una raccolta di funzionalità della pianta come edifici, livelli e stanze.The dataset is a collection of map features, such as buildings, levels, and rooms. Per creare un set di dati, usare l'API Dataset Create.To create a dataset, use the Dataset Create API. L'API Dataset Create accetta il conversionId per il pacchetto di disegno convertito e restituisce un datasetId del set di dati creato.The dataset Create API takes the conversionId for the converted Drawing package and returns a datasetId of the created dataset. La procedura seguente mostra come creare un set di dati.The steps below show you how to create a dataset.

  1. Nell'applicazione Postman selezionare New (Nuovo).In the Postman application, select New. Nella finestra Create New (Crea nuovo) selezionare Request (Richiesta).In the Create New window, select Request. Immettere un Request name (Nome richiesta) e selezionare una raccolta.Enter a Request name and select a collection. Fare clic su Save (Salva).Click Save

  2. Per creare un nuovo set di dati, creare una richiesta POST all'API Dataset Create.Make a POST request to the Dataset Create API to create a new dataset. Prima di inviare la richiesta, accodare sia la chiave di sottoscrizione sia il conversionId con il conversionId ottenuto durante il processo di conversione nel passaggio 5.Before submitting the request, append both your subscription key and the conversionId with the conversionId obtained during the Conversion process in step 5. La richiesta deve essere simile all'URL seguente:The request should look like the following URL:

    https://atlas.microsoft.com/dataset/create?api-version=1.0&conversionID={conversionId}&type=facility&subscription-key={Azure-Maps-Primary-Subscription-key}
    
  3. Ottenere lo statusURL nella chiave Location (Posizione) degli Header (Intestazioni) di risposta.Obtain the statusURL in the Location key of the response Headers.

  4. Effettuare una richiesta GET allo statusURL per ottenere il datasetId.Make a GET request at the statusURL to obtain the datasetId. Accodare la chiave di sottoscrizione primaria di Mappe di Azure per l'autenticazione.Append your Azure Maps primary subscription key for authentication. La richiesta deve essere simile all'URL seguente:The request should look like the following URL:

    https://atlas.microsoft.com/dataset/operations/<operationId>?api-version=1.0&subscription-key={Azure-Maps-Primary-Subscription-key}
    
  5. Quando la richiesta HTTP GET viene completata correttamente, l'intestazione della risposta conterrà il datasetId per il set di dati creato.When the GET HTTP request completes successfully, the response header will contain the datasetId for the created dataset. Copiare datasetId.Copy the datasetId. Per creare un set di tessere è necessario usare datasetId.You'll need to use the datasetId to create a tileset.

    {
        "operationId": "a93570cb-3e4f-4e45-a2b1-360df174180a",
        "created": "2020-04-22T19:52:38.9352189+00:00",
        "status": "Succeeded",
        "resourceLocation": "https://azure.microsoft.com/dataset/{datasetiId}?api-version=1.0"
     }
    

Creare un set di tessereCreate a tileset

Un set di tessere è un set di tessere vettoriali che esegue il rendering sulla mappa.A tileset is a set of vector tiles that render on the map. I set di tessere vengono creati da set di dati esistenti.Tilesets are created from existing datasets. Tuttavia, un set di tessere è indipendente dal set di dati da cui è originato.However, a tileset is independent from the dataset from which it was sourced. Se il set di dati viene eliminato, il set di tessere continuerà a esistere.If the dataset is deleted, the tileset will continue to exist. Per creare un set di tessere, seguire la procedura seguente:To create a tileset, follow the steps below:

  1. Nell'applicazione Postman selezionare New (Nuovo).In the Postman application, select New. Nella finestra Create New (Crea nuovo) selezionare Request (Richiesta).In the Create New window, select Request. Immettere un Request name (Nome richiesta) e selezionare una raccolta.Enter a Request name and select a collection. Fare clic su Save (Salva).Click Save

  2. Creare una richiesta POST nella scheda del generatore. La richiesta URL dovrebbe essere simile all'URL seguente:Make a POST request in the builder tab. The request URL should look like the following URL:

    https://atlas.microsoft.com/tileset/create/vector?api-version=1.0&datasetID={datasetId}&subscription-key={Azure-Maps-Primary-Subscription-key}
    
  3. Effettuare una richiesta GET allo statusURL per il set di tessere.Make a GET request at the statusURL for the tileset. Accodare la chiave di sottoscrizione primaria di Mappe di Azure per l'autenticazione.Append your Azure Maps primary subscription key for authentication. La richiesta deve essere simile all'URL seguente:The request should look like the following URL:

     https://atlas.microsoft.com/tileset/operations/<operationId>?api-version=1.0&subscription-key=<Azure-Maps-Primary-Subscription-key>
    
  4. Quando la richiesta HTTP GET viene completata correttamente, l'intestazione della risposta conterrà il tilesetId per il set di tessere creato.When the GET HTTP request completes successfully, the response header will contain the tilesetId for the created tileset. Copiare tilesetId.Copy the tilesetId.

    {
        "operationId": "a93570cb-3e4f-4e45-a2b1-360df174180a",
        "createdDateTime": "3/11/2020 8:45:13 PM +00:00",
        "status": "Succeeded",
        "resourceLocation": "https://atlas.microsoft.com/tileset/{tilesetId}?api-version=1.0"
    }
    

Eseguire query sui set di dati con l'API WFSQuery datasets with WFS API

È possibile eseguire query sui set di dati usando l'API WFS.Datasets can be queried using WFS API. Con l'API WFS è possibile eseguire una query per le raccolte di funzionalità, per una raccolta specifica o per una funzionalità specifica con una funzionalità ID.With the WFS API you can query for feature collections, a specific collection, or a specific feature with a feature ID. La funzionalità ID identifica in modo univoco la funzionalità all'interno del set di dati.The feature ID uniquely identifies the feature within the dataset. Viene usato, ad esempio, per identificare lo stato della funzionalità da aggiornare all'interno di un determinato set di stati.It's used, for example, to identify which feature state should be updated in a given stateset.

  1. Nell'applicazione Postman selezionare New (Nuovo).In the Postman application, select New. Nella finestra Create New (Crea nuovo) selezionare Request (Richiesta).In the Create New window, select Request. Immettere un Request name (Nome richiesta) e selezionare una raccolta.Enter a Request name and select a collection. Fare clic su Save (Salva).Click Save

  2. Effettuare una richiesta GET per visualizzare un elenco delle raccolte nel set di dati.Make a GET request to view a list of the collections in your dataset. Sostituire <dataset-id> con il datasetId.Replace <dataset-id> with your datasetId. Usare la chiave primaria di Mappe di Azure invece del segnaposto.Use your Azure Maps primary key instead of the placeholder. La richiesta deve essere simile all'URL seguente:The request should look like the following URL:

    https://atlas.microsoft.com/wfs/datasets/{datasetId}/collections?subscription-key={Azure-Maps-Primary-Subscription-key}&api-version=1.0
    
  3. Il corpo della risposta verrà fornito in formato GeoJSON e conterrà tutte le raccolte all'interno del set di dati.The response body will be delivered in GeoJSON format and will contain all collections in the dataset. Per semplicità, l'esempio mostra solo la raccolta unit.For simplicity, the example here only shows the unit collection. Per un esempio contenente tutte le raccolte, vedere API WFS - Descrizioni raccolte.To see an example that contains all collections, see WFS Describe Collections API. Per altre informazioni sulle raccolte è possibile fare clic su uno degli URL all'interno dell'elemento link.To learn more about any collection, you can click on any of the URLs inside the link element.

    {
    "collections": [
        {
            "name": "unit",
            "description": "A physical and non-overlapping area which might be occupied and traversed by a navigating agent. Can be a hallway, a room, a courtyard, etc. It is surrounded by physical obstruction (wall), unless the is_open_area attribute is equal to true, and one must add openings where the obstruction shouldn't be there. If is_open_area attribute is equal to true, all the sides are assumed open to the surroundings and walls are to be added where needed. Walls for open areas are represented as a line_element or area_element with is_obstruction equal to true.",
            "links": [
                {
                    "href": "https://atlas.microsoft.com/wfs/datasets/{datasetId}/collections/unit/definition?api-version=1.0",
                    "rel": "describedBy",
                    "title": "Metadata catalogue for unit"
                },
                {
                    "href": "https://atlas.microsoft.com/wfs/datasets/{datasetId}/collections/unit/items?api-version=1.0",
                    "rel": "data",
                    "title": "unit"
                }
                {
                    "href": "https://atlas.microsoft.com/wfs/datasets/{datasetId}/collections/unit?api-version=1.0",
                    "rel": "self",
                    "title": "Metadata catalogue for unit"
                }
            ]
        },
    
  4. Effettuare una richiesta GET per le raccolte di funzionalità di unit.Make a GET request for the unit feature collections. Sostituire {datasetId} con il datasetId.Replace {datasetId} with your datasetId. Usare la chiave primaria di Mappe di Azure invece del segnaposto.Use your Azure Maps primary key instead of the placeholder. Il corpo della risposta conterrà tutte le funzionalità della raccolta unit.The response body will contain all the features of the unit collection. La richiesta deve essere simile all'URL seguente:The request should look like the following URL:

    https://atlas.microsoft.com/wfs/datasets/{datasetId}/collections/unit/items?subscription-key={Azure-Maps-Primary-Subscription-key}&api-version=1.0
    
  5. Copiare la funzionalità id per una funzionalità di unità con proprietà di stile che possono essere modificate dinamicamente.Copy the feature id for a unit feature that has style properties that can be dynamically modified. Dato che la temperatura e lo stato di occupazione delle unità possono essere aggiornati dinamicamente, nella sezione successiva verrà usata la funzionalità id.Because the unit occupancy status and temperature can be dynamically updated, we'll use this feature id in the next section. Nell'esempio seguente la proprietà id è "UNIT26".In the following example, the feature id is "UNIT26". si fa riferimento alle proprietà di stile di questa funzionalità come stati e viene usata la funzionalità per creare un set di stati.we'll refer to the style properties of this feature as states, and we'll use the feature to make a stateset.

    {
       "type": "FeatureCollection",
       "features": [
           {
               "type": "Feature",
               "geometry": {
                   "type": "Polygon",
                   "coordinates": ["..."]
               },
               "properties": {
                   "original_id": "b7410920-8cb0-490b-ab23-b489fd35aed0",
                   "category_id": "CTG8",
                   "is_open_area": true,
                   "navigable_by": [
                       "pedestrian"
                   ],
                   "route_through_behavior": "allowed",
                   "level_id": "LVL14",
                   "occupants": [],
                   "address_id": "DIR1",
                   "name": "157"
               },
               "id": "UNIT26",
               "featureType": ""
           }, {"..."}
       ]
    }
    

Creare un set di stati della funzionalitàCreate a feature stateset

  1. Nell'applicazione Postman selezionare New (Nuovo).In the Postman application, select New. Nella finestra Create New (Crea nuovo) selezionare Request (Richiesta).In the Create New window, select Request. Immettere un Request name (Nome richiesta) e selezionare una raccolta.Enter a Request name and select a collection. Fare clic su Save (Salva).Click Save

  2. Effettuare una richiesta POST all'API Create Stateset.Make a POST request to the Create Stateset API. Usare il datasetId del set di dati che contiene lo stato che si vuole modificare.Use the datasetId of the dataset that contains the state you want to modify. La richiesta deve essere simile all'URL seguente:The request should look like the following URL:

    https://atlas.microsoft.com/featureState/stateset?api-version=1.0&datasetId={datasetId}&subscription-key={Azure-Maps-Primary-Subscription-key}
    
  3. Negli Headers (Intestazioni) della richiesta POST, impostare Content-Type su application/json.In the Headers of the POST request, set Content-Type to application/json. In Body (Corpo), specificare gli stili seguenti per riflettere le modifiche apportate agli stati occupied e temperature.In the Body, provide the styles below to reflect changes to the occupied and temperature states. Al termine, fare clic su Send(Invia).When you're done, click Send.

    {
       "styles":[
          {
             "keyname":"occupied",
             "type":"boolean",
             "rules":[
                {
                   "true":"#FF0000",
                   "false":"#00FF00"
                }
             ]
          },
          {
             "keyname":"temperature",
             "type":"number",
             "rules":[
                {
                   "range":{
                      "exclusiveMaximum":66
                   },
                   "color":"#00204e"
                },
                {
                   "range":{
                      "minimum":66,
                      "exclusiveMaximum":70
                   },
                   "color":"#0278da"
                },
                {
                   "range":{
                      "minimum":70,
                      "exclusiveMaximum":74
                   },
                   "color":"#187d1d"
                },
                {
                   "range":{
                      "minimum":74,
                      "exclusiveMaximum":78
                   },
                   "color":"#fef200"
                },
                {
                   "range":{
                      "minimum":78,
                      "exclusiveMaximum":82
                   },
                   "color":"#fe8c01"
                },
                {
                   "range":{
                      "minimum":82
                   },
                   "color":"#e71123"
                }
             ]
          }
       ]
    }
    
  4. Copiare lo statesetId dal corpo dalla risposta.Copy the statesetId from the response body.

  5. Creare una richiesta POST per aggiornare lo stato: Passare lo statesetId e la funzionalità ID con la chiave di sottoscrizione di Mappe di Azure.Create a POST request to update the state: Pass the statesetId and feature ID with your Azure Maps subscription key. La richiesta deve essere simile all'URL seguente:The request should look like the following URL:

    https://atlas.microsoft.com/featureState/state?api-version=1.0&statesetID={statesetId}&featureID={featureId}&subscription-key={Azure-Maps-Primary-Subscription-key}
    
  6. Negli Headers (Intestazioni) della richiesta POST, impostare Content-Type su application/json.In the Headers of the POST request, set Content-Type to application/json. Nel BODY (CORPO) della richiesta POST copiare e incollare il codice JSON nell'esempio seguente.In the BODY of the POST request, copy and paste the JSON in the sample below.

    {
        "states": [
            {
                "keyName": "occupied",
                "value": true,
                "eventTimestamp": "2019-11-14T17:10:20"
            }
        ]
    }
    

    Nota

    L'aggiornamento verrà salvato solo se lo stamp relativo all'ora di pubblicazione è successivo al timestamp della richiesta precedente.The update will only be saved if the time posted stamp is after the time stamp of the previous request. È possibile passare qualsiasi nome di chiave configurato in precedenza durante la creazione.We can pass any keyname that we've previously configured during creation.

  7. Dopo un aggiornamento correttamente completato, si riceve un codice di stato HTTP 200 OK.Upon a successful update, you'll receive a 200 OK HTTP status code. Se è stato implementato lo stile dinamico per una pianta interna, l'aggiornamento viene visualizzato nella pianta di cui è stato eseguito il rendering al timestamp specificato.If you have dynamic styling implemented for an indoor map, the update will display in your rendered map at the specified time stamp.

L'API Feature Get States consente di recuperare lo stato di una funzionalità usando la relativa funzionalità ID.The Feature Get States API allows you to retrieve the state of a feature using its feature ID. È anche possibile eliminare i set di stati e le relative risorse usando l'API Feature State Delete.You can also delete the stateset and its resources by using the Feature State Delete API.

Passaggi successiviNext steps

In questa esercitazione sono state illustrate le procedure per:In this tutorial, you learned how to:

  • Caricare il pacchetto di disegno della pianta di interniUpload your indoor map Drawing package
  • Convertire il pacchetto di disegno in dati della piantaConvert your Drawing package into map data
  • Creare un set di dati dai dati della piantaCreate a dataset from your map data
  • Creare un set di tessere a partire dai dati nel set di datiCreate a tileset from the data in your dataset
  • Eseguire una query sul servizio WFS Mappe di Azure per ottenere informazioni sulle funzionalità della piantaQuery the Azure Maps WFS service to learn about your map features
  • Creare un set di stati delle funzionalità usando le funzionalità della pianta e i dati nel set di datiCreate a feature stateset by using your map features and the data in your dataset
  • Aggiornare il set di stati della funzionalitàUpdate your feature stateset

A questo punto si hanno le competenze necessarie per passare alle guide successive:You're now equipped with the skills you need to move on to the next guides:

Informazioni sui diversi servizi di Mappe di Azure descritti in questo articolo:Learn more about the different Azure Maps services discussed in this article: