Data

API för borttagning av data

Gäller för: Prisnivån S1.

Med det här API:et kan anroparen ta bort ett innehåll som laddats upp tidigare.

Du kan använda det här API:et i ett scenario som att ta bort geofences som tidigare laddats upp med hjälp av Data Upload-API:et för användning i vår Azure Kartor Geofencing-tjänst. Du kan också använda det här API:et för att ta bort gammalt/oanvänt uppladdat innehåll och skapa utrymme för nytt innehåll.

Skicka borttagningsbegäran

Om du vill ta bort ditt innehåll utfärdar DELETE du en begäran där sökvägen innehåller de data som ska tas udid bort.

Om du till exempel vill ta bort en samling geofences som tidigare laddats upp med hjälp av Upload-API:et anger du parametern i sökvägen till för de data som togs emot tidigare i udid udid API-svaret för uppladdning.

Ta bort datasvar

API:et för borttagning av data returnerar ett HTTP-svar med en tom brödtext om 204 No Content dataresursen har tagits bort.

Ett 400 Bad Request HTTP-felsvar returneras om dataresursen med det skickade udid inte hittas.

API för nedladdning av data

Gäller för: Prisnivån S1.

Med det här API:et kan anroparen ladda ned ett tidigare uppladdat datainnehåll.

Du kan använda det här API:et i ett scenario som att ladda ned en befintlig samling geofences som laddats upp tidigare med hjälp av Data Upload-API:et för användning i vår Azure Kartor Geofencing-tjänst.

Skicka nedladdningsbegäran

För att ladda ned ditt innehåll använder GET du en begäran där sökvägen innehåller de data som ska laddas udid ned. Du kan också skicka in en rubrik Accept för att ange en inställning för Content-Type datasvaret.
Om du till exempel vill ladda ned en samling geofences som tidigare laddades upp med hjälp av Upload-API:et anger du parametern i sökvägen till för de data som togs emot tidigare i API-uppladdningssvaret och anger rubriken till någon av följande udid udid Accept medietyper:

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

Ladda ned datasvar

Api:et för nedladdning returnerar ett HTTP-svar om dataresursen med den skickade filen hittas, där svarstexten innehåller innehållet 200 OK udid i dataresursen.
Ett 400 Bad Request HTTP-felsvar returneras om dataresursen med det skickade udid inte hittas.

Här är ett exempel på svarstext för en enkel geofence som representeras i och som GeoJSON laddats upp tidigare med hjälp Upload API:et:

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

API för datalista

Gäller för: Prisnivån S1.

Med det här API:et kan anroparen hämta en lista över allt innehåll som laddats upp tidigare med hjälp av API:et Data Upload.

Begäran om att skicka lista

Om du vill visa en lista med allt ditt kartdatainnehåll utfärdar GET du en begäran utan ytterligare parametrar.

Visa datasvar

API:et för datalista returnerar den fullständiga listan över alla data i json formatet. Svaret innehåller följande information för varje dataresurs:

udid – unikt data-ID för dataresursen.

location – Platsen för dataresursen. Kör en HTTP GET på den här platsen för att ladda ned data.

Här är ett exempelsvar som returnerar udid location och för 3 dataresurser:

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

API för datauppdatering

Gäller för: Prisnivån S1.

Med API:et för datauppdatering kan anroparen uppdatera ett innehåll som laddats upp tidigare.

Du kan använda det här API:et i ett scenario som att lägga till eller ta bort geofences till eller från en befintlig samling geofences. Geofences laddas upp med hjälp av API:Upload dataoch används i Azure Kartor Geofencing Service.

Observera att uppdaterings-API:et ersätter och åsidosätter det befintliga datainnehållet.

Skicka uppdateringsbegäran

Du kommer att använda en begäran för att uppdatera PUT ditt innehåll. Begärandetexten innehåller nya data som ersätter befintliga data. Huvudet Content-Type ställs in på datainnehållstypen och sökvägen innehåller för de data som ska udid uppdateras.

Om du till exempel vill uppdatera en samling geofences som tidigare har laddats upp med hjälp av Upload-API:et placerar du det nya geofence-innehållet i begärandetexten. Ange udid parametern i sökvägen till för de udid data som togs emot tidigare i API-uppladdningssvaret. Och ange Content-Type rubriken till någon av följande medietyper:

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

Här är ett exempel på en begärandetext för att uppdatera en enkel Geofence. Den representeras som en cirkelgeometri med hjälp av en mittpunkt och en radie. Exemplet nedan finns i GeoJSON :

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

Den tidigare uppladdade geofence hade en radie på 100 m. Ovanstående begäran uppdaterar den till 500 m.

API:et för datauppdatering utför en långvarig begäran.

Datauppdateringsgränser

Tänk på att för närvarande har varje Azure Kartor-konto en datalagringsgräns. När lagringsgränsen har nåtts returnerar alla nya API-anrop för uppladdning ett 409 Conflict HTTP-felsvar. Du kan alltid använda API:et för borttagning av data för att ta bort gammalt/oanvänt innehåll och skapa utrymme för nya uppladdningar.

API för Upload data

Gäller för: Prisnivån S1.

Med DATA Upload-API:et kan anroparen ladda upp datainnehåll till Azure Kartor-tjänsten. Du kan använda det här API:et i ett scenario som att ladda upp en samling Geofences i format, för användning i GeoJSON vår Azure Kartor Geofencing Service.

Skicka Upload begäran

För att ladda upp ditt innehåll använder du en POST begäran. Begärandetexten innehåller de data som ska laddas upp. Rubriken Content-Type ställs in på innehållstypen för data.

Om du till exempel vill ladda upp en samling geofences i format anger du GeoJSON begärandetexten till geofence-innehållet. Ange dataFormat frågeparametern till geojson och ange Content-Type rubriken till någon av följande medietyper:

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

Här är ett exempel på en begärandetext för att ladda upp en enkel Geofence som representeras som en cirkelgeometri med en mittpunkt och en radie. Exemplet nedan finns i GeoJSON :

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

Data Upload-API:et utför en långvarig begäran.

Databegränsningar Upload data

Tänk på att för närvarande har varje Azure Kartor-konto en datalagringsgräns. När lagringsgränsen har nåtts returnerar alla nya API-anrop för uppladdning ett 409 Conflict HTTP-felsvar. Du kan alltid använda API:et för borttagning av data för att ta bort gammalt/oanvänt innehåll och skapa utrymme för nya uppladdningar.