Data

Rozhraní API pro odstranění dat

Platí pro: Cenová úroveň S1.

Toto rozhraní API umožňuje volajícímu odstranit dříve nahraný obsah dat.

Toto rozhraní API můžete použít ve scénáři, jako je odebrání dříve nahraných geografických hran pomocí rozhraní Data Upload API pro použití v naší službě Azure Mapy Geofencing Service. Pomocí tohoto rozhraní API můžete také odstranit starý/nepoužívaný nahraný obsah a vytvořit prostor pro nový obsah.

Odeslání žádosti o odstranění

Pokud chcete odstranit obsah, vydáte DELETE požadavek, ve kterém bude cesta obsahovat udid data, která se mají odstranit.

Pokud například chcete odstranit kolekci geografických hran dříve nahraných pomocí rozhraní Upload API, nastavte parametr v cestě k datům přijatých dříve v odpovědi rozhraní udid udid API pro nahrání.

Odpověď na odstranění dat

Pokud byl prostředek dat úspěšně odstraněn, rozhraní API pro odstranění dat vrátí odpověď HTTP s 204 No Content prázdným textem.

Pokud se prostředek dat s předaným souborem nenašel, vrátí se 400 Bad Request udid chybová odpověď HTTP.

Rozhraní API pro stahování dat

Platí pro: Cenová úroveň S1.

Toto rozhraní API umožňuje volajícímu stáhnout dříve nahraný datový obsah.

Toto rozhraní API můžete použít ve scénáři, jako je stažení existující kolekce geografických hran dříve nahraných pomocí rozhraní Data Upload API pro použití v naší službě Azure Mapy Geofencing Service.

Odeslání žádosti o stažení

Ke stažení obsahu použijete GET požadavek, ve kterém bude cesta obsahovat data ke udid stažení. Volitelně můžete také předat Accept hlavičku a zadat předvolbu Content-Type odpovědi na data.
Pokud například chcete stáhnout kolekci geografických položek dříve nahraných pomocí rozhraní Upload API, nastavte parametr v cestě k datům přijatých dříve v odpovědi rozhraní API pro nahrání a nastavte hlavičku na některý z následujících udid udid typů Accept médií:

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

Stažení odpovědi na data

Rozhraní API pro stahování vrátí odpověď HTTP, pokud se našlo datové prostředky s předaným souborem , kde text odpovědi bude obsahovat 200 OK udid obsah datového prostředku.
Pokud se prostředek dat s předaným souborem nenašel, vrátí se 400 Bad Request udid chybová odpověď HTTP.

Tady je ukázkový text odpovědi pro jednoduchou geografickou replikaci reprezentované v nahrání dříve GeoJSON pomocí Upload API:

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

Rozhraní API pro seznam dat

Platí pro: Cenová úroveň S1.

Toto rozhraní API umožňuje volajícímu načíst seznam veškerého obsahu nahraného dříve pomocí rozhraní Data Upload API.

Odeslání žádosti o seznam

Pokud chcete zobrazit seznam veškerého obsahu mapových dat, vydáte GET požadavek bez dalších parametrů.

Odpověď na seznam dat

Rozhraní API pro seznam dat vrátí úplný seznam všech dat ve json formátu . Odpověď obsahuje následující podrobnosti o každém datovém prostředku:

udid – jedinečné ID dat pro datový prostředek.

location – umístění datového prostředku. Spusťte v tomto umístění http GET a stáhněte data.

Tady je ukázková odpověď, která vrací a udid location ze 3 datových prostředků:

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

Rozhraní API pro aktualizaci dat

Platí pro: Cenová úroveň S1.

Rozhraní API pro aktualizaci dat umožňuje volajícímu aktualizovat dříve nahraný obsah dat.

Toto rozhraní API můžete použít ve scénáři, jako je přidání nebo odebrání geografické oblasti do nebo z existující kolekce geografických ence. Geografické údaje se nahrávají pomocí rozhraní Data Upload APIpro použití ve službě Azure Mapy Geofencing Service.

Upozorňujeme, že rozhraní Update API nahradí a přepíše stávající obsah dat.

Odeslání žádosti o aktualizaci

K aktualizaci obsahu použijete PUT požadavek. Text požadavku bude obsahovat nová data, která nahradí existující data. Hlavička se nastaví na typ obsahu dat a cesta bude obsahovat Content-Type udid data, která se mají aktualizovat.

Pokud například chcete aktualizovat kolekci geografických hran, které byly dříve nahrané pomocí rozhraní API Upload, umístěte nový obsah geografické oblasti do textu požadavku. Nastavte udid parametr v cestě k datům přijatých dříve v odpovědi rozhraní API pro udid nahrávání. A nastavte Content-Type hlavičku na jeden z následujících typů médií:

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

Tady je ukázkový text požadavku pro aktualizaci jednoduché geografické gefence. Reprezentuje se jako geometrie kruhu pomocí středového bodu a poloměru. Níže uvedená ukázka je v GeoJSON souboru :

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

Dříve nahraná geofence měla poloměr 100 m. Výše uvedený požadavek ho aktualizuje na 500 min.

Rozhraní API pro aktualizaci dat provádí dlouhotrvá žádost.

Omezení aktualizace dat

Upozorňujeme, že v současné době má každý účet azure Mapy limit úložiště dat. Po dosažení limitu úložiště vrátí všechna nová volání rozhraní API pro nahrávání chybovou 409 Conflict odpověď HTTP. Rozhraní API pro odstranění dat můžete vždy použít k odstranění starého nebo nepoužívaného obsahu a k vytvoření prostoru pro nové nahrávání.

Rozhraní API pro Upload dat

Platí pro: Cenová úroveň S1.

Rozhraní DATA Upload API umožňuje volajícímu nahrát obsah dat do služby Azure Mapy service. Toto rozhraní API můžete použít ve scénáři, jako je nahrání kolekce geografických hran ve formátu pro použití v naší službě GeoJSON Azure Mapy Geofencing Service.

Odeslání Upload žádosti

K nahrání obsahu použijete POST žádost. Text požadavku bude obsahovat data, která se mají nahrát. Hlavička Content-Type se nastaví na typ obsahu dat.

Pokud chcete například nahrát kolekci geografických hran ve formátu, nastavte text požadavku GeoJSON na obsah geografické oblasti. Nastavte dataFormat parametr dotazu na geojson a nastavte hlavičku na jeden z Content-Type následujících typů médií:

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

Tady je ukázkový text požadavku pro nahrání jednoduché geofence reprezentované jako geometrie s kruhem pomocí středového bodu a poloměru. Níže uvedená ukázka je v GeoJSON souboru :

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

Rozhraní API Upload provádí dlouhotrvá žádost.

Omezení Upload dat

Upozorňujeme, že v současné době má každý účet azure Mapy limit úložiště dat. Po dosažení limitu úložiště vrátí všechna nová volání rozhraní API pro nahrávání chybovou 409 Conflict odpověď HTTP. Rozhraní API pro odstranění dat můžete vždy použít k odstranění starého nebo nepoužívaného obsahu a k vytvoření prostoru pro nové nahrávání.