Dataset

Van toepassing op: zie prijscategorie .

Met Creator kunt u toepassingen ontwikkelen op basis van uw persoonlijke plattegrondgegevens met behulp van azure Kaarten API en SDK. In dit artikel worden concepten en hulpprogramma's beschreven die van toepassing zijn op Azure Kaarten Creator.

Met deze API kan de aanroeper een gegevensset maken van gegevens die zijn geüpload naar de Azure Kaarten Data Service en zijn geconverteerd met behulp van de Azure Kaarten Conversion Service.

U kunt deze API gebruiken in een scenario zoals het uploaden van een DWG-zip-pakket voor een gebouw, het converteren van het zip-pakket met behulp van de Azure Kaarten Conversion Service en het maken van een gegevensset op basis van het geconverteerde ZIP-pakket. De gemaakte gegevensset kan worden gebruikt om tegelsets te maken met behulp van de Azure Kaarten Tileset Service en kan worden opgevraagd via de Azure Kaarten WFS-service.

Aanvraag voor maken indienen

Als u uw gegevensset wilt maken, gebruikt u een aanvraag waarbij de queryparameter een id is die het geconverteerde POST DWG-zip-pakket vertegenwoordigt. De parameter is de id van een eerder gemaakte gegevensset die moet worden toegevoegd aan de huidige gegevensset en optioneel bevat de queryparameter een beschrijving (als de beschrijving niet is opgegeven, wordt er een standaardbeschrijving conversionId datasetId description gegeven).

De API maken is een langlopende aanvraag.

Van toepassing op: zie prijscategorie .

Met Creator kunt u toepassingen ontwikkelen op basis van uw persoonlijke plattegrondgegevens met behulp van azure Kaarten API en SDK. In dit artikel worden concepten en hulpprogramma's beschreven die van toepassing zijn op Azure Kaarten Creator.

U kunt deze API ook gebruiken om oude/ongebruikte gegevenssets te verwijderen om ruimte te maken voor nieuwe Creator-inhoud.

Verwijderaanvraag verzenden

Als u uw inhoud wilt verwijderen, moet u een aanvraag indienen waarbij het pad de bevat DELETE datasetId van de gegevensset die u wilt verwijderen.

Van toepassing op: zie prijscategorie .

Met Creator kunt u toepassingen ontwikkelen op basis van uw persoonlijke plattegrondgegevens met behulp van azure Kaarten API en SDK. In dit artikel worden concepten en hulpprogramma's beschreven die van toepassing zijn op Azure Kaarten Creator.

Met deze API kan de aanroeper een eerder gemaakte gegevensset ophalen.

Aanvraag voor get-details verzenden

Als u de details voor een eerder gemaakte gegevensset wilt op halen, moet u een GET aanvraag indienen met de in het datasetId pad.

Antwoord op details krijgen

De GET Details-API retourneert de details voor een gegevensset in json indeling. Het antwoord bevat de volgende velden (als deze niet null of leeg zijn):

created: het tijdstempel dat de gegevensset is gemaakt. datasetId: de id voor de gegevensset. description: de beschrijving voor de gegevensset. datasetSources: de brongegevens die zijn gebruikt bij het maken van de aanvraag. ontology: de bron ontologie die is gebruikt in de conversieservice voor de invoergegevens.

De beschrijft de brongegevens die zijn gebruikt bij het maken van de aanvraag en bevat de volgende elementen (als deze niet datasetSources null of leeg zijn):

conversionIds: de lijst conversionId met (null als er geen is opgegeven). appendDatasetId: de die is gebruikt voor een bewerking voor het datasetId append (null als er geen is gebruikt). featureCounts: de tellingen voor elk functietype in de gegevensset.

Hier is een voorbeeld van een antwoord dat de timestamp , , , , en van een datasetId description datasetSources ontology gegevenssetresource retournt:

{
   "timestamp": "2020-01-01T22:50:48.123Z",
   "datasetId": "f6495f62-94f8-0ec2-c252-45626f82fcb2",
   "description": "Some description or comment for the dataset.",
   "datasetSources": {
     "conversionIds": [
       "15d21452-c9bb-27b6-5e79-743ca5c3205d"
     ],
   },
   "ontology": "facility-2.0",
   "featureCounts": {
     "directoryInfo": 2,
     "category": 10,
     "facility": 1,
     "level": 3,
     "unit": 183,
     "zone": 3,
     "verticalPenetration": 6,
     "opening": 48,
     "areaElement": 108
   }
 }

Met deze API kan de aanroeper de huidige voortgang van een gegevenssetbewerking bekijken en wordt het pad verkregen via een aanroep naar de API maken.

Aanvraag voor verzenden van bewerkingen

Als u de huidige voortgang van een gegevenssetbewerking wilt bekijken, gebruikt u een aanvraag waarbij de opgegeven het pad de id is die GET operationId de bewerking vertegenwoordigt.

Bewerkingsreactie

Terwijl de code wordt uitgevoerd, 200-OK wordt er een HTTP-statuscode geretourneerd zonder extra headers. Als de bewerking is geslaagd, wordt er 200-OK een HTTP-statuscode met Resource-Location header geretourneerd.

Van toepassing op: zie prijscategorie .

Met Creator kunt u toepassingen ontwikkelen op basis van uw persoonlijke plattegrondgegevens met behulp van azure Kaarten API en SDK. In dit artikel worden concepten en hulpprogramma's beschreven die van toepassing zijn op Azure Kaarten Creator.

Met deze API kan de aanroeper een lijst ophalen met alle eerder gemaakte gegevenssets.

Lijstaanvraag indienen

Als u een lijst met al uw gegevenssets wilt maken, moet u een GET aanvraag indienen zonder extra parameters.

Gegevensreactie op een lijst

De Lijst-API retourneert de volledige lijst met alle gegevenssets in json de indeling. Het antwoord bevat de volgende velden (als deze niet null of leeg zijn):

created: het tijdstempel dat de gegevensset is gemaakt. datasetId: de id voor de gegevensset. description: de beschrijving voor de gegevensset. datasetSources: de brongegevens die zijn gebruikt bij het maken van de aanvraag. ontology: de bron ontologie die is gebruikt in de conversieservice voor de invoergegevens.

De beschrijft de brongegevens die zijn gebruikt bij het maken van de aanvraag en bevat de volgende elementen (als deze niet datasetSources null of leeg zijn):

conversionIds: de lijst conversionId met (null als er geen is opgegeven). appendDatasetId: de die is gebruikt voor een bewerking voor het datasetId append (null als er geen is gebruikt). featureCounts: de tellingen voor elk functietype in de gegevensset.

Hier is een voorbeeld van een antwoord dat de timestamp resources , , , en van drie datasetId description datasetSources ontology gegevenssets retournt:

{
  "datasets": [
    {
      "timestamp": "2020-01-01T22:50:48.123Z",
      "datasetId": "f6495f62-94f8-0ec2-c252-45626f82fcb2",
      "description": "Some description or comment for the dataset.",
      "datasetSources": {
        "conversionIds": [
          "15d21452-c9bb-27b6-5e79-743ca5c3205d"
        ],      },
      "ontology": "facility-2.0",
      "featureCounts": {
        "directoryInfo": 2,
        "category": 10,
        "facility": 1,
        "level": 3,
        "unit": 183,
        "zone": 3,
        "verticalPenetration": 6,
        "opening": 48,
        "areaElement": 108
      }
    },
    {
      "timestamp": "2020-01-01T22:57:53.123Z",
      "datasetId": "8b1288fa-1958-4a2b-b68e-13a7i5af7d7c",
      "description": "Create from upload '0c1288fa-2058-4a1b-b68d-13a5f5af7d7c'.",
      "datasetSources": {
        "conversionIds": [
          "0c1288fa-2058-4a1b-b68d-13a5f5af7d7c"
        ],
        "appendDatasetId": "46d1edb6-d29e-4786-9589-dbd4efd7a977"
      },
      "ontology": "facility-2.0",
      "featureCounts": {
        "directoryInfo": 2,
        "category": 10,
        "facility": 1,
        "level": 3,
        "unit": 183,
        "zone": 3,
        "verticalPenetration": 6,
        "opening": 48,
        "areaElement": 108
      }
    }
  ]
}