Data

  • Referentie
Service:
Maps
API Version:
1.0

Operations

Delete Preview

API voor het verwijderen van gegevens

Van toepassing op: Prijscategorie S1.

Met deze API kan de aanroeper eerder geüploade gegevensinhoud verwijderen.

U kunt deze API gebruiken in een scenario zoals het verwijderen van geofences die eerder zijn geüpload met behulp van de Data Upload-API voor gebruik in onze Azure Kaarten Geofencing Service. U kunt deze API ook gebruiken om oude/ongebruikte geüploade inhoud te verwijderen en ruimte te maken voor nieuwe inhoud.

Aanvraag voor verwijderen verzenden

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

Als u bijvoorbeeld een verzameling geofences wilt verwijderen die eerder zijn geüpload met behulp van de Upload-API, stelt u de parameter in het pad in op de van de gegevens die eerder zijn ontvangen in het antwoord van de api voor udid udid uploaden.

Gegevensreactie verwijderen

De API voor het verwijderen van gegevens retourneert een HTTP-antwoord met een lege body als de 204 No Content gegevensresource is verwijderd.

Er wordt 400 Bad Request een HTTP-foutbericht geretourneerd als de gegevensresource met de doorgegeven fout udid niet is gevonden.
Download Preview

API voor het downloaden van gegevens

Van toepassing op: Prijscategorie S1.

Met deze API kan de aanroeper eerder geüploade gegevensinhoud downloaden.

U kunt deze API gebruiken in een scenario zoals het downloaden van een bestaande verzameling geofences die eerder zijn geüpload met behulp van de Data Upload-API voor gebruik in onze Azure Kaarten Geofencing Service.

Downloadaanvraag verzenden

Als u uw inhoud wilt downloaden, gebruikt u een aanvraag waarin het pad de GET van de te downloaden gegevens udid bevat. U kunt eventueel ook een header doorgeven om een voorkeur voor de van het Accept Content-Type gegevensreactie op te geven.
Als u bijvoorbeeld een verzameling geofences wilt downloaden die eerder zijn geüpload met behulp van de Upload-API, stelt u de parameter in het pad in op de van de gegevens die eerder zijn ontvangen in het antwoord van de upload-API en stelt u de header in op een van de volgende udid udid Accept mediatypen:

  • application/json
  • application/vnd.geo+json
  • application/octet-stream

Gegevensreactie downloaden

De Download-API retourneerde een HTTP-antwoord als de gegevensresource met de doorgegeven is gevonden, waarbij de antwoord-body de inhoud van 200 OK udid de gegevensresource bevat.
Er wordt 400 Bad Request een HTTP-foutbericht geretourneerd als de gegevensresource met de doorgegeven fout udid niet is gevonden.

Hier is een voorbeeld van een antwoord voor een eenvoudige geofence die eerder is geüpload met behulp van de GeoJSON Upload API: 

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-122.126986, 47.639754]
        },
        "properties": {
            "geometryId": "001",
            "radius": 500
        }
    }]
}
List Preview

Gegevenslijst-API

Van toepassing op: Prijscategorie S1.

Met deze API kan de aanroeper een lijst ophalen met alle inhoud die eerder is geüpload met behulp van de Data Upload API.

Lijstaanvraag indienen

Als u al uw kaartgegevensinhoud wilt weergeven, moet u een GET aanvraag indienen zonder extra parameters.

Gegevensreactie op een lijst

De gegevenslijst-API retourneert de volledige lijst met alle gegevens in json de indeling. Het antwoord bevat de volgende details voor elke gegevensresource:

udid: de unieke gegevens-id voor de gegevensresource.

location: de locatie van de gegevensresource. Voer een HTTP GET uit op deze locatie om de gegevens te downloaden.

Hier is een voorbeeld van een antwoord dat de udid en van location drie gegevensbronnen retournt:


{
    "mapDataList": 
    [
        {
            "udid": "9a1288fa-1858-4a3b-b68d-13a8j5af7d7c",
            "location": "https://atlas.microsoft.com/mapData/9a1288fa-1858-4a3b-b68d-13a8j5af7d7c?api-version=1.0",
            "sizeInBytes": 29920,
            "uploadStatus": "Completed"
        },
        {
            "udid": "8b1288fa-1958-4a2b-b68e-13a7i5af7d7c",
            "location": "https://atlas.microsoft.com/mapData/8b1288fa-1958-4a2b-b68e-13a7i5af7d7c?api-version=1.0",
            "sizeInBytes": 1339,
            "uploadStatus": "Completed"
        },
        {
            "udid": "7c1288fa-2058-4a1b-b68f-13a6h5af7d7c",
            "location": "https://atlas.microsoft.com/mapData/7c1288fa-2058-4a1b-b68f-13a6h5af7d7c?api-version=1.0",
            "sizeInBytes": 1650,
            "uploadStatus": "Pending"
        }]
}

Update Preview

API voor gegevensupdates

Van toepassing op: Prijscategorie S1.

Met de API voor gegevensupdates kan de aanroeper een eerder geüploade gegevensinhoud bijwerken.

U kunt deze API gebruiken in een scenario zoals het toevoegen of verwijderen van geofences aan of uit een bestaande verzameling geofences. Geofences worden geüpload met behulp van de Data Upload-APIvoor gebruik in de Azure Kaarten Geofencing Service.

Houd er rekening mee dat de Update-API de bestaande gegevensinhoud vervangt en overschrijven.

Updateaanvraag verzenden

Als u uw inhoud wilt bijwerken, gebruikt u een PUT aanvraag. De aanvraag body bevat de nieuwe gegevens die de bestaande gegevens vervangen. De header wordt ingesteld op het inhoudstype van de gegevens en het pad bevat de van de Content-Type gegevens die moeten worden udid bijgewerkt.

Als u bijvoorbeeld een verzameling geofences wilt bijwerken die eerder zijn geüpload met behulp van de Upload-API, moet u de nieuwe geofence-inhoud in de aanvraag body plaatsen. Stel de udid parameter in het pad in op de van de gegevens die eerder zijn ontvangen in het antwoord van udid de upload-API. En stel de Content-Type header in op een van de volgende mediatypen:

  • application/json
  • application/vnd.geo+json
  • application/octet-stream

Hier is een voorbeeld van een aanvraag voor het bijwerken van een eenvoudige Geofence. Het wordt weergegeven als een cirkelgeometrie met behulp van een middelpunt en een radius. Het onderstaande voorbeeld is in GeoJSON :

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-122.126986, 47.639754]
        },
        "properties": {
            "geometryId": "001",
            "radius": 500
        }
    }]
}

De eerder geofence geüploade had een radius van 100m. De bovenstaande aanvraag wordt bijgewerkt naar 500 m.

Met de Api voor gegevensupdates wordt een langlopende aanvraag uitgevoerd.

Limieten voor gegevensupdates

Houd er rekening mee dat momenteel voor elk Azure Kaarten-account een gegevensopslaglimiet geldt. Zodra de opslaglimiet is bereikt, retourneren alle nieuwe API-aanroepen voor uploaden een 409 Conflict HTTP-foutbericht. U kunt altijd de API voor het verwijderen van gegevens gebruiken om oude/ongebruikte inhoud te verwijderen en ruimte te maken voor nieuwe uploads.
Upload Preview

Data Upload-API

Van toepassing op: Prijscategorie S1.

Met de Data Upload-API kan de aanroeper gegevensinhoud uploaden naar de Azure Kaarten service. U kunt deze API gebruiken in een scenario zoals het uploaden van een verzameling Geofences in indeling, voor gebruik in onze GeoJSON Azure Kaarten Geofencing Service.

Een Upload verzenden

Als u uw inhoud wilt uploaden, gebruikt u een POST aanvraag. De aanvraag body bevat de gegevens die moeten worden geüpload. De Content-Type header wordt ingesteld op het inhoudstype van de gegevens.

Als u bijvoorbeeld een verzameling geofences in indeling wilt uploaden, stelt u de aanvraag body in GeoJSON op de geofence-inhoud. Stel de dataFormat queryparameter in op geojson en stel de header in op Content-Type een van de volgende mediatypen:

  • application/json
  • application/vnd.geo+json
  • application/octet-stream

Hier is een voorbeeld van een aanvraag voor het uploaden van een eenvoudige Geofence die wordt weergegeven als een cirkelgeometrie met behulp van een middelpunt en een radius. Het onderstaande voorbeeld is in GeoJSON :

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-122.126986, 47.639754]
        },
        "properties": {
            "geometryId": "001",
            "radius": 500
        }
    }]
}

De Data Upload-API voert een langlopende aanvraag uit.

Limieten Upload gegevenslimieten

Houd er rekening mee dat momenteel voor elk Azure Kaarten-account een gegevensopslaglimiet geldt. Zodra de opslaglimiet is bereikt, retourneren alle nieuwe API-aanroepen voor uploaden een 409 Conflict HTTP-foutbericht. U kunt altijd de API voor het verwijderen van gegevens gebruiken om oude/ongebruikte inhoud te verwijderen en ruimte te maken voor nieuwe uploads.