Usar o Criador para criar mapas internosUse Creator to create indoor maps

Este tutorial mostra como criar mapas internos.This tutorial shows you how to create indoor maps. Neste tutorial, você aprenderá como usar a API para:In this tutorial, you'll learn how to use the API to:

  • Carregar seu pacote do Drawing de mapa internoUpload your indoor map Drawing package
  • Converter seu pacote do Drawing em dados do mapaConvert your Drawing package into map data
  • Criar um conjunto de dados de seus dados de mapaCreate a dataset from your map data
  • Criar um conjunto de peças dos dados em seu conjunto de dadosCreate a tileset from the data in your dataset
  • Consultar a API do WFS (Web Feature Service) do Azure Mapas para saber mais sobre seus recursos de mapaQuery the Azure Maps Web Feature Service (WFS) API to learn about your map features
  • Criar um conjunto de estados do recurso usando seus recursos de mapa e os dados em seu conjunto de dadosCreate a feature stateset by using your map features and the data in your dataset
  • Atualizar seu conjunto de estados do recursoUpdate your feature stateset

Pré-requisitosPrerequisites

Para criar mapas internos:To create indoor maps:

  1. Faça uma conta do Azure MapasMake an Azure Maps account
  2. Obtenha uma chave de assinatura primária, também conhecida como a chave primária ou a chave de assinatura.Obtain a primary subscription key, also known as the primary key or the subscription key.
  3. Crie um recurso do CriadorCreate a Creator resource
  4. Baixe o pacote de exemplo do Drawing.Download the Sample Drawing package.

Este tutorial usa o aplicativo Postman, mas você pode escolher um ambiente de desenvolvimento de API diferente.This tutorial uses the Postman application, but you may choose a different API development environment.

Importante

As URLs de API neste documento podem precisar ser ajustadas de acordo com o local do recurso de criador.The API urls in this document may have to be adjusted according to the location of your Creator resource. Para obter mais detalhes, consulte acesso aos serviços do criador.For more details, see Access to Creator Services.

Carregar um pacote do DrawingUpload a Drawing package

Use a API de upload de dados para carregar o pacote do Drawing nos recursos do Azure Mapas.Use the Data Upload API to upload the Drawing package to Azure Maps resources.

A API de upload de dados é uma transação de execução prolongada que implementa o padrão definido aqui.The Data Upload API is a long running transaction that implements the pattern defined here. Quando a operação for concluída, usaremos o udid para acessar o pacote carregado para convertê-lo.Once the operation completes, we'll use the udid to access the uploaded package to convert it. Siga as etapas abaixo para obter udid.Follow the steps below to obtain the udid.

  1. Abra o aplicativo Postman.Open the Postman app. Próximo à parte superior do aplicativo Postman, selecione Novo.Near the top of the Postman app, select New. Na janela Criar, selecione Coleção.In the Create New window, select Collection. Nomeie a coleção e selecione o botão Criar.Name the collection and select the Create button.

  2. Para criar a solicitação, selecione Novo outra vez.To create the request, select New again. Na janela Criar, selecione Solicitação.In the Create New window, select Request. Insira um Nome de solicitação para a solicitação.Enter a Request name for the request. Selecione a coleção que você criou na etapa anterior e clique em Salvar.Select the collection you created in the previous step, and then select Save.

  3. Selecione o método HTTP POST na guia do construtor e insira a URL a seguir para carregar o pacote do Drawing no serviço do Azure Mapas.Select the POST HTTP method in the builder tab and enter the following URL to upload the Drawing package to the Azure Maps service. Para essa solicitação e outras solicitações mencionadas neste artigo, substitua {Azure-Maps-Primary-Subscription-key} pela sua chave de assinatura primária.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. Na guia Cabeçalhos, especifique um valor para a chave Content-Type.In the Headers tab, specify a value for the Content-Type key. O pacote do Drawing é uma pasta compactada, portanto, use o valor application/octet-stream.The Drawing package is a zipped folder, so use the application/octet-stream value. Na guia Corpo, selecione binário.In the Body tab, select binary. Clique em Selecionar Arquivo e escolha um pacote do Drawing.Click on Select File and choose a Drawing package.

    data-management

  5. Clique no botão azul Enviar e aguarde a solicitação ser processada.Click the blue Send button and wait for the request to process. Depois que a solicitação for concluída, vá para a guia Cabeçalhos da resposta.Once the request completes, go to the Headers tab of the response. Copie o valor da chave Local, que é status URL.Copy the value of the Location key, which is the status URL.

  6. Para verificar o status da chamada à API, crie uma solicitação HTTP Get no status URL .To check the status of the API call, create a GET HTTP request on the status URL. Você precisará acrescentar sua chave de assinatura primária à URL para autenticação.You'll need to append your primary subscription key to the URL for authentication. A solicitação Get deve ser semelhante à seguinte URL: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 a solicitação HTTP Get for concluída com êxito, ela retornará um resourceLocation .When the GET HTTP request completes successfully, it will return a resourceLocation. O resourceLocation contém o exclusivo udid para o conteúdo carregado.The resourceLocation contains the unique udid for the uploaded content. Opcionalmente, você pode usar a resourceLocation URL para recuperar metadados desse recurso na próxima etapa.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. Para recuperar metadados de conteúdo, crie uma solicitação HTTP Get na resourceLocation URL que foi recuperada na etapa 7.To retrieve content metadata, create a GET HTTP request on the resourceLocation URL that was retrieved in step 7. Certifique-se de acrescentar sua chave de assinatura primária à URL para autenticação.Make sure to append your primary subscription key to the URL for authentication. A solicitação Get deve ser semelhante à seguinte URL: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 a solicitação HTTP Get for concluída com êxito, o corpo da resposta conterá o udid especificado na resourceLocation da etapa 7, o local para acessar/baixar o conteúdo no futuro e outros metadados sobre o conteúdo, como data de criação/atualização, tamanho e assim por diante.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. Um exemplo da resposta geral é: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"
    }
    

Converter um pacote do DrawingConvert a Drawing package

Agora que o pacote do Drawing foi carregado, usaremos udid para o pacote carregado converter o pacote em dados do mapa.Now that the Drawing package is uploaded, we'll use udid for the uploaded package to convert the package into map data. A API de conversão usa uma transação de execução prolongada que implementa o padrão definido aqui.The Conversion API uses a long running transaction that implements the pattern defined here. Quando a operação for concluída, usaremos o conversionId para acessar os dados convertidos.Once the operation completes, we'll use the conversionId to access the converted data. Siga as etapas abaixo para obter conversionId.Follow the steps below to obtain the conversionId.

  1. Selecione Novo.Select New. Na janela Criar, selecione Solicitação.In the Create New window, select Request. Insira o Nome da solicitação e selecione uma coleção.Enter a Request name and select a collection. Clique em Save (Salvar).Click Save.

  2. Selecione o método HTTP POST na guia do construtor e insira a URL a seguir para converter o pacote do Drawing carregado nos dados do mapa.Select the POST HTTP method in the builder tab and enter the following URL to convert your uploaded Drawing package into map data. Use o udid para o pacote carregado.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

    As URLs de API neste documento podem precisar ser ajustadas de acordo com o local do recurso de criador.The API urls in this document may have to be adjusted according to the location of your Creator resource. Para obter mais detalhes, consulte acesso aos serviços do criador.For more details, see Access to Creator Services.

  3. Clique no botão Enviar e aguarde a solicitação ser processada.Click the Send button and wait for the request to process. Depois que a solicitação for concluída, vá para a guia Cabeçalhos da resposta e procure pela chave Local.Once the request completes, go to the Headers tab of the response, and look for the Location key. Copie o valor da chave Local, que é status URL, para a solicitação de conversão.Copy the value of the Location key, which is the status URL for the conversion request.

  4. Inicie um novo método HTTP GET na guia do construtor. Acrescente sua chave de assinatura primária do Azure Mapas ao status URL.Start a new GET HTTP method in the builder tab. Append your Azure Maps primary subscription key to the status URL. Faça uma solicitação GET em status URL da etapa anterior.Make a GET request at the status URL from the previous step. Se o processo de conversão ainda não tiver sido concluído, você poderá ver algo semelhante à seguinte resposta JSON: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. Depois que a solicitação for concluída com êxito, você verá uma mensagem de status de êxito no corpo da resposta.Once the request completes successfully, you'll see a success status message in the response body. Copie conversionId da URL resourceLocation para o pacote convertido.Copy the conversionId from the resourceLocation URL for the converted package. O conversionId é usado por outra API para acessar os dados de mapa convertidos.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": {}
    }
    

Observação

O aplicativo Postman não dá suporte nativo a solicitações HTTP de execução prolongada.The Postman application does not natively support HTTP Long Running Requests. Como resultado, você poderá notar um longo atraso ao fazer uma solicitação GET na URL de status.As a result, you may notice a long delay while making a GET request at the status URL. Aguarde cerca de trinta segundos e tente clicar no botão Enviar novamente até que a resposta mostre êxito ou falha.Wait about thirty seconds and try clicking the Send button again until the response shows success or fail.

O pacote de exemplo do Drawing deve ser convertido sem erros ou avisos.The sample Drawing package should be converted without errors or warnings. No entanto, se você receber erros ou avisos de seu próprio pacote do Drawing, a resposta JSON fornecerá um link para o visualizador de erros do Drawing.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. O visualizador de erros do Drawing permite inspecionar os detalhes de erros e avisos.The Drawing Error visualizer allows you to inspect the details of errors and warnings. Para receber recomendações sobre como resolver erros e avisos de conversão, consulte Erros e avisos de conversão do Drawing.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"
    }
}

Criar um conjunto de dadosCreate a dataset

O conjunto de dados é uma coleção de recursos de mapa, como edifícios, níveis e salas.The dataset is a collection of map features, such as buildings, levels, and rooms. Para criar um conjunto de dados, use a API de criação de conjunto de dados.To create a dataset, use the Dataset Create API. A API de criação de conjunto de dados pega conversionId para o pacote do Drawing convertido e retorna um datasetId do conjunto de dados criado.The dataset Create API takes the conversionId for the converted Drawing package and returns a datasetId of the created dataset. As etapas abaixo mostram como criar um conjunto de dados.The steps below show you how to create a dataset.

  1. No aplicativo Postman, selecione Novo.In the Postman application, select New. Na janela Criar, selecione Solicitação.In the Create New window, select Request. Insira o Nome da solicitação e selecione uma coleção.Enter a Request name and select a collection. Clique em SalvarClick Save

  2. Faça uma solicitação POST à API de criação de conjunto de dados para criar um conjunto de dados.Make a POST request to the Dataset Create API to create a new dataset. Antes de enviar a solicitação, acrescente sua chave de assinatura e o conversionId com o conversionId obtido durante o processo de conversão na etapa 5.Before submitting the request, append both your subscription key and the conversionId with the conversionId obtained during the Conversion process in step 5. A solicitação deve ser semelhante à seguinte URL: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. Obtenha o statusURL na chave Local dos Cabeçalhos de resposta.Obtain the statusURL in the Location key of the response Headers.

  4. Faça uma solicitação GET no statusURL para obter o datasetId.Make a GET request at the statusURL to obtain the datasetId. Acrescente sua chave de assinatura primária do Azure Mapas para autenticação.Append your Azure Maps primary subscription key for authentication. A solicitação deve ser semelhante à seguinte URL: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 a solicitação HTTP GET for concluída com êxito, o cabeçalho de resposta conterá o datasetId para o conjunto de dados criado.When the GET HTTP request completes successfully, the response header will contain the datasetId for the created dataset. Copie datasetId.Copy the datasetId. Você precisará usar o datasetId para criar um conjunto de peças.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"
     }
    

Criar um conjunto de peçasCreate a tileset

Um conjunto de peças é um conjunto de peças de vetor que são renderizadas no mapa.A tileset is a set of vector tiles that render on the map. Os conjuntos de peças são criados usando conjuntos de dados existentes.Tilesets are created from existing datasets. No entanto, um conjunto de peças é independente do conjunto de dados do qual foi originado.However, a tileset is independent from the dataset from which it was sourced. Se o conjunto de dados for excluído, o conjunto de peças continuará a existir.If the dataset is deleted, the tileset will continue to exist. Para criar um conjunto de peças, siga as etapas abaixo:To create a tileset, follow the steps below:

  1. No aplicativo Postman, selecione Novo.In the Postman application, select New. Na janela Criar, selecione Solicitação.In the Create New window, select Request. Insira o Nome da solicitação e selecione uma coleção.Enter a Request name and select a collection. Clique em SalvarClick Save

  2. Faça uma solicitação POST na guia do construtor. A URL de solicitação deve ser semelhante à seguinte URL: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. Faça uma solicitação GET no statusURL para o conjunto de peças.Make a GET request at the statusURL for the tileset. Acrescente sua chave de assinatura primária do Azure Mapas para autenticação.Append your Azure Maps primary subscription key for authentication. A solicitação deve ser semelhante à seguinte URL: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 a solicitação HTTP GET for concluída com êxito, o cabeçalho de resposta conterá o tilesetId para o conjunto de peças criado.When the GET HTTP request completes successfully, the response header will contain the tilesetId for the created tileset. Copie 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"
    }
    

Consultar conjuntos de dados com a API do WFSQuery datasets with WFS API

Os conjuntos de dados podem ser consultados usando a API do WFS.Datasets can be queried using WFS API. Com a API do WFS, você pode consultar coleções de recursos, uma coleção específica ou um recurso específico com um recurso ID.With the WFS API you can query for feature collections, a specific collection, or a specific feature with a feature ID. O recurso ID identifica exclusivamente o recurso no conjunto de dados.The feature ID uniquely identifies the feature within the dataset. Ele é usado, por exemplo, para identificar qual estado do recurso deve ser atualizado em um determinado conjunto de dados.It's used, for example, to identify which feature state should be updated in a given stateset.

  1. No aplicativo Postman, selecione Novo.In the Postman application, select New. Na janela Criar, selecione Solicitação.In the Create New window, select Request. Insira o Nome da solicitação e selecione uma coleção.Enter a Request name and select a collection. Clique em SalvarClick Save

  2. Faça uma solicitação GET para exibir uma lista das coleções no conjunto de dados.Make a GET request to view a list of the collections in your dataset. Substitua <dataset-id> por seu datasetId.Replace <dataset-id> with your datasetId. Use sua chave primária do Azure Mapas em vez do espaço reservado.Use your Azure Maps primary key instead of the placeholder. A solicitação deve ser semelhante à seguinte URL: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. O corpo da resposta será entregue no formato GeoJSON e conterá todas as coleções no conjunto de dados.The response body will be delivered in GeoJSON format and will contain all collections in the dataset. Para simplificar, o exemplo aqui mostra apenas a coleção unit.For simplicity, the example here only shows the unit collection. Para ver um exemplo que contém todas as coleções, consulte WFS: API de descrição de coleções.To see an example that contains all collections, see WFS Describe Collections API. Para saber mais sobre coleções, você pode clicar em uma das URLs dentro do 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. Faça uma solicitação GET para as coleções de recursos do unit.Make a GET request for the unit feature collections. Substitua {datasetId} por seu datasetId.Replace {datasetId} with your datasetId. Use sua chave primária do Azure Mapas em vez do espaço reservado.Use your Azure Maps primary key instead of the placeholder. O corpo da resposta conterá todos os recursos da coleção unit.The response body will contain all the features of the unit collection. A solicitação deve ser semelhante à seguinte URL: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. Copie o recurso id para um recurso de unidade que tenha propriedades de estilo que possam ser modificadas dinamicamente.Copy the feature id for a unit feature that has style properties that can be dynamically modified. Como o status de ocupação da unidade e a temperatura podem ser atualizados dinamicamente, usaremos esse recurso id na próxima seção.Because the unit occupancy status and temperature can be dynamically updated, we'll use this feature id in the next section. No exemplo a seguir, o recurso id é "UNIT26".In the following example, the feature id is "UNIT26". Vamos nos referir às propriedades de estilo desse recurso como estados e usaremos o recurso para fazer um conjunto de estados.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": ""
           }, {"..."}
       ]
    }
    

Criar um conjunto de estados do recursoCreate a feature stateset

  1. No aplicativo Postman, selecione Novo.In the Postman application, select New. Na janela Criar, selecione Solicitação.In the Create New window, select Request. Insira o Nome da solicitação e selecione uma coleção.Enter a Request name and select a collection. Clique em SalvarClick Save

  2. Faça uma solicitação POST para a API de criação de conjunto de estados.Make a POST request to the Create Stateset API. Use o datasetId do conjunto de dados que contém o estado que você deseja modificar.Use the datasetId of the dataset that contains the state you want to modify. A solicitação deve ser semelhante à seguinte URL: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. Nos Cabeçalhos da solicitação POST, defina Content-Type como application/json.In the Headers of the POST request, set Content-Type to application/json. No Corpo, forneça os estilos abaixo para refletir as alterações feitas nos estados occupied e temperature.In the Body, provide the styles below to reflect changes to the occupied and temperature states. Ao terminar, clique em Enviar.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. Copie statesetId do corpo da resposta.Copy the statesetId from the response body.

  5. Crie uma solicitação POST para atualizar o estado: Passe o statesetId e o recurso ID com sua chave de assinatura do Azure Mapas.Create a POST request to update the state: Pass the statesetId and feature ID with your Azure Maps subscription key. A solicitação deve ser semelhante à seguinte URL: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. Nos Cabeçalhos da solicitação POST, defina Content-Type como application/json.In the Headers of the POST request, set Content-Type to application/json. No CORPO da solicitação POST, copie e cole o JSON no exemplo abaixo.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"
            }
        ]
    }
    

    Observação

    A atualização só será salva se o carimbo de data/hora postado for posterior ao carimbo de data/hora da solicitação anterior.The update will only be saved if the time posted stamp is after the time stamp of the previous request. Podemos passar qualquer keyname que configuramos anteriormente durante a criação.We can pass any keyname that we've previously configured during creation.

  7. Após uma atualização bem-sucedida, você receberá um código de status HTTP 200 OK.Upon a successful update, you'll receive a 200 OK HTTP status code. Se você tiver o estilo dinâmico implementado para um mapa interno, a atualização será exibida no mapa renderizado no carimbo de data/hora especificado.If you have dynamic styling implemented for an indoor map, the update will display in your rendered map at the specified time stamp.

A API de obtenção de estados do recurso permite que você recupere o estado de um recurso usando seu recurso ID.The Feature Get States API allows you to retrieve the state of a feature using its feature ID. Você também pode excluir o conjunto de estados e seus recursos usando a API de exclusão de estado do recurso.You can also delete the stateset and its resources by using the Feature State Delete API.

Próximas etapasNext steps

Neste tutorial, você aprendeu a:In this tutorial, you learned how to:

  • Carregar seu pacote do Drawing de mapa internoUpload your indoor map Drawing package
  • Converter seu pacote do Drawing em dados do mapaConvert your Drawing package into map data
  • Criar um conjunto de dados de seus dados de mapaCreate a dataset from your map data
  • Criar um conjunto de peças dos dados em seu conjunto de dadosCreate a tileset from the data in your dataset
  • Consultar o serviço WFS do Azure Mapas para saber mais sobre seus recursos de mapaQuery the Azure Maps WFS service to learn about your map features
  • Criar um conjunto de estados do recurso usando seus recursos de mapa e os dados em seu conjunto de dadosCreate a feature stateset by using your map features and the data in your dataset
  • Atualizar seu conjunto de estados do recursoUpdate your feature stateset

Agora você está equipado com as habilidades que precisa para avançar para os próximos guias:You're now equipped with the skills you need to move on to the next guides:

Saiba mais sobre os diferentes serviços do Azure Mapas discutidos neste artigo:Learn more about the different Azure Maps services discussed in this article: