Zelfstudie: Azure Kaarten Creator gebruiken om indoorkaarten te maken

  • Artikel

In deze zelfstudie wordt beschreven hoe u indoorkaarten maakt voor gebruik in Microsoft Azure Kaarten. In deze zelfstudie ziet u hoe u:

  • Upload uw tekenpakket voor indoorkaarten.
  • Converteer uw tekenpakket naar kaartgegevens.
  • Maak een gegevensset op basis van uw kaartgegevens.
  • Maak een tegelset op basis van de gegevens in uw gegevensset.
  • Haal de standaardconfiguratie-id van de kaart op uit uw tegelset.

U kunt ook een gegevensset maken op basis van een GeoJSON-pakket. Zie Een gegevensset maken met behulp van een GeoJSON-pakket (preview) voor meer informatie.

Vereisten

In deze zelfstudie wordt de Postman-toepassing gebruikt, maar u kunt een andere API-ontwikkelomgeving gebruiken.

Belangrijk

  • In dit artikel wordt de us.atlas.microsoft.com geografische URL gebruikt. Als uw Creator-service niet is gemaakt in de Verenigde Staten, moet u een andere geografische URL gebruiken. Zie Access to Creator-services voor meer informatie.
  • Vervang in de URL-voorbeelden door {Your-Azure-Maps-Subscription-key} uw Azure Kaarten-abonnementssleutel.

Een tekenpakket uploaden

Volg de stappen in het artikel Gegevensregister maken om het GeoJSON-pakket te uploaden naar uw Azure-opslagaccount en registreer het vervolgens in uw Azure Kaarten-account.

Belangrijk

Noteer de unieke id (udid)-waarde die u nodig hebt. U udid verwijst naar het GeoJSON-pakket dat u hebt geüpload naar uw Azure-opslagaccount vanuit uw broncode en HTTP-aanvragen.

Een tekenpakket converteren

Nu het tekenpakket is geüpload, gebruikt u de udid waarde voor het geüploade pakket om het pakket te converteren naar kaartgegevens. De conversie-API maakt gebruik van een langlopende transactie waarmee het patroon wordt geïmplementeerd dat is gedefinieerd in het artikel Langlopende bewerking maker.

Een tekenpakket converteren:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer voor aanvraagnaam een naam in voor de aanvraag, zoals POST-tekenpakket converteren.

  4. Selecteer de POST HTTP-methode.

  5. Voer de volgende URL in voor de conversieservice. Vervang door {Your-Azure-Maps-Subscription-key} uw Azure Kaarten-abonnementssleutel. Vervang door udid de udid waarde van het geüploade pakket.

    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. Selecteer Verzenden.

  7. Selecteer in het antwoordvenster het tabblad Kopteksten .

  8. Kopieer de waarde van de sleutel Operation-Location . Deze bevat de status-URL die u gebruikt om de status van de conversie te controleren.

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

Controleer de status van de conversie van het tekenpakket

Nadat de conversiebewerking is voltooid, wordt een conversionId waarde geretourneerd. U kunt toegang krijgen tot de conversionId waarde door de status van het conversieproces van het tekenpakket te controleren. Vervolgens kunt u de conversionId waarde gebruiken om toegang te krijgen tot de geconverteerde gegevens.

De status van het conversieproces controleren en de conversionId waarde ophalen:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer voor de aanvraagnaam een naam in voor de aanvraag, zoals GET-conversiestatus.

  4. Selecteer de GET HTTP-methode.

  5. Voer de status-URL in die u hebt gekopieerd in de sectie Een tekenpakket converteren. De aanvraag moet lijken op de volgende URL:

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

  6. Selecteer Verzenden.

  7. Selecteer in het antwoordvenster het tabblad Kopteksten .

  8. Kopieer de waarde van de sleutel Resourcelocatie , de URL van de resourcelocatie. De URL van de resourcelocatie bevat de unieke id conversionId, die andere API's gebruiken voor toegang tot de geconverteerde kaartgegevens.

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

Het voorbeeldtekeningspakket moet zonder fouten of waarschuwingen worden geconverteerd. Maar als u fouten of waarschuwingen van uw eigen tekenpakket ontvangt, bevat het JSON-antwoord een koppeling naar de visualisatie van tekenfouten. U kunt de visualisatiefunctie voor tekenfouten gebruiken om de details van fouten en waarschuwingen te controleren. Zie Fouten en waarschuwingen voor tekenenconversie om aanbevelingen te krijgen voor het oplossen van conversiefouten en -waarschuwingen.

In het volgende JSON-fragment wordt een voorbeeld van een conversiewaarschuwing weergegeven:

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

Een gegevensset maken

Een gegevensset is een verzameling kaartfuncties, zoals gebouwen, niveaus en ruimten. Als u een gegevensset wilt maken, gebruikt u de API voor het maken van gegevenssets. De API voor het maken van gegevenssets gebruikt de conversionId waarde voor het geconverteerde tekenpakket en retourneert een datasetId waarde voor de gemaakte gegevensset.

Een gegevensset maken:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer bij Aanvraagnaam een naam in voor de aanvraag, zoals POST Dataset Create.

  4. Selecteer de POST HTTP-methode.

  5. Voer de volgende URL in voor de gegevenssetservice. Vervang {conversionId} door de conversionId waarde die u hebt verkregen in Controleer de status van de conversie van het tekenpakket.

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

  6. Selecteer Verzenden.

  7. Selecteer in het antwoordvenster het tabblad Kopteksten .

  8. Kopieer de waarde van de sleutel Operation-Location . Deze bevat de status-URL die u gebruikt om de status van de gegevensset te controleren.

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

Controleer de status van het maken van de gegevensset

De status van het proces voor het maken van de gegevensset controleren en de datasetId waarde ophalen:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer voor de aanvraagnaam een naam in voor de aanvraag, zoals get-gegevenssetstatus.

  4. Selecteer de GET HTTP-methode.

  5. Voer de status-URL in die u hebt gekopieerd in de sectie Een gegevensset maken. De aanvraag moet lijken op de volgende URL:

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

  6. Selecteer Verzenden.

  7. Selecteer in het antwoordvenster het tabblad Kopteksten . De waarde van de sleutel Resourcelocatie is de URL van de resourcelocatie. De URL van de resourcelocatie bevat de unieke id (datasetId) van de gegevensset.

  8. Sla de datasetId waarde op, omdat u deze in de volgende zelfstudie gaat gebruiken.

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

Tegelset maken

Een tegelset is een set vectortegels die op de kaart worden weergegeven. Tegelsets worden gemaakt op basis van bestaande gegevenssets. Een tegelset is echter onafhankelijk van de gegevensset waaruit deze afkomstig is. Als de gegevensset wordt verwijderd, blijft de tegelset bestaan.

Een tegelset maken:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer bij Aanvraagnaam een naam in voor de aanvraag, zoals POST-tegelset Maken.

  4. Selecteer de POST HTTP-methode.

  5. Voer de volgende URL in voor de Tegelset-service. Vervang door {datasetId} de datasetId waarde die u hebt verkregen in de sectie Status van het maken van de gegevensset controleren.

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

  6. Selecteer Verzenden.

  7. Selecteer in het antwoordvenster het tabblad Kopteksten .

  8. Kopieer de waarde van de sleutel Operation-Location . Deze bevat de status-URL, die u gebruikt om de status van de tegelset te controleren.

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

Controleer de status van het maken van tegelset

De status van het proces voor het maken van tegelsets controleren en de tilesetId waarde ophalen:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer voor de aanvraagnaam een naam in voor de aanvraag, zoals get-tegelsetstatus.

  4. Selecteer de GET HTTP-methode.

  5. Voer de status-URL in die u hebt gekopieerd in de sectie Een tegelset maken. De aanvraag moet lijken op de volgende URL:

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

  6. Selecteer Verzenden.

  7. Selecteer in het antwoordvenster het tabblad Kopteksten . De waarde van de sleutel Resourcelocatie is de URL van de resourcelocatie. De URL van de resourcelocatie bevat de unieke id (tilesetId) van de gegevensset.

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

De kaartconfiguratie ophalen (preview)

Nadat u een tegelset hebt gemaakt, kunt u de mapConfigurationId waarde ophalen met behulp van de tegelset http-aanvraag ophalen:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer voor de aanvraagnaam een naam in voor de aanvraag, zoals GET mapConfigurationId uit De tegelset.

  4. Selecteer de GET HTTP-methode.

  5. Voer de volgende URL in voor de Tegelset-service. Geef de tegelset-id door die u in de vorige stap hebt verkregen.

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

  6. Selecteer Verzenden.

  7. De tegelset JSON wordt weergegeven in de hoofdtekst van het antwoord. Schuif omlaag om de mapConfigurationId waarde te zien:

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

Zie Kaartconfiguratie in het artikel over concepten van indoorkaart voor meer informatie.

Volgende stappen

Wat is Azure Kaarten Creator?

Maker voor indoorkaarten

De Azure Kaarten Indoor Kaarten-module gebruiken met aangepaste stijlen