Data

Operations

Delete Preview

Interfejs API usuwania danych

Dotyczy: Warstwa cenowa S1.

Ten interfejs API umożliwia obiektowi wywołującemu usunięcie wcześniej przekazanej zawartości danych.

Tego interfejsu API można używać w scenariuszu, takim jak usuwanie z geoogrodzenia, które zostały wcześniej przekazane przy użyciu interfejsu API przekazywania danych do użycia w naszej usłudze Azure Maps geogeofencingu. Za pomocą tego interfejsu API można także usunąć starą/nieużywaną zawartość i utworzyć miejsce dla nowej zawartości.

Prześlij żądanie usunięcia

Aby usunąć zawartość, należy wydać żądanie, w DELETE której ścieżka będzie zawierać udid dane do usunięcia.

Na przykład aby usunąć kolekcję elementów geograficznych, które zostały wcześniej przekazane przy użyciu interfejsu API przekazywania, należy ustawić udid parametr w ścieżce do udid danych odebranych wcześniej w odpowiedzi interfejsu API przekazywania.

Usuń odpowiedź na dane

Interfejs API usuwania danych zwraca odpowiedź HTTP 204 No Content z pustą treścią, jeśli zasób danych został usunięty pomyślnie.

Odpowiedź na 400 Bad Request błąd http zostanie zwrócona, jeśli nie zostanie znaleziony zasób danych z przekazaniem udid .

Download Preview

Interfejs API pobierania danych

Dotyczy: Warstwa cenowa S1.

Ten interfejs API umożliwia obiektowi wywołującemu pobranie wcześniej przekazanej zawartości danych.

Tego interfejsu API można użyć w scenariuszu, takim jak pobranie istniejącej kolekcji geoogrodzenia przekazanej wcześniej przy użyciu interfejsu API przekazywania danych do użycia w naszej usłudze Azure MapsGeo.

Prześlij żądanie pobrania

Aby pobrać zawartość, będziesz używać żądania, GET gdzie ścieżka będzie zawierać udid dane do pobrania. Opcjonalnie można również przekazać Accept nagłówek, aby określić preferencję Content-Type odpowiedzi na dane.
Na przykład aby pobrać kolekcję elementów geograficznych, które zostały wcześniej przekazane przy użyciu interfejsu API przekazywania, należy ustawić udid parametr w ścieżce do udid danych odebranych wcześniej w odpowiedzi interfejsu API przekazywania i ustawić Accept nagłówek na jeden z następujących typów nośników:

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

Pobierz odpowiedź na dane

Interfejs API pobierania zwróci 200 OK odpowiedź HTTP, jeśli zostanie znaleziony zasób danych z zatwierdzono udid , gdzie treść odpowiedzi będzie zawierać zawartość zasobu danych.
Odpowiedź na 400 Bad Request błąd http zostanie zwrócona, jeśli nie zostanie znaleziony zasób danych z przekazaniem udid .

Oto przykładowa treść odpowiedzi dla prostego elementu geoogrodzenia reprezentowanego GeoJSON wcześniej przy użyciu interfejsu API przekazywania:

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

Interfejs API listy danych

Dotyczy: Warstwa cenowa S1.

Ten interfejs API umożliwia obiektowi wywołującemu pobranie listy wszystkich przekazanych wcześniej zawartości przy użyciu interfejsu API przekazywania danych.

Żądanie przesłania listy

Aby wyświetlić listę wszystkich zawartości danych mapy, należy wydać GET żądanie bez dodatkowych parametrów.

Wyświetl odpowiedź na dane

Interfejs API listy danych zwraca kompletną listę wszystkich danych w json formacie. Odpowiedź zawiera następujące szczegóły dotyczące poszczególnych zasobów danych:

UDID — unikatowy identyfikator danych dla zasobu danych.

Lokalizacja — Lokalizacja zasobu danych. Wykonaj polecenie HTTP GET w tej lokalizacji, aby pobrać dane.

Oto przykładowa odpowiedź zwracająca udid i location 3 zasoby danych:


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

Interfejs API aktualizacji danych

Dotyczy: Warstwa cenowa S1.

Interfejs API aktualizacji danych umożliwia obiektowi wywołującemu aktualizację wcześniej przekazanej zawartości danych.

Tego interfejsu API można używać w scenariuszu, takim jak dodawanie lub usuwanie granic do lub z istniejącej kolekcji geoogrodzeniów. Geoogrodzenia są przekazywane przy użyciu interfejsu API przekazywania danychdo użycia w usłudze Azure MapsGeo.

Należy pamiętać, że interfejs API aktualizacji zamieni i zastąpi istniejącą zawartość danych.

Prześlij żądanie aktualizacji

Aby zaktualizować zawartość, będziesz używać PUT żądania. Treść żądania będzie zawierać nowe dane, które zastąpią istniejące dane. Content-TypeNagłówek zostanie ustawiony na typ zawartości danych, a ścieżka będzie zawierać udid dane, które mają zostać zaktualizowane.

Na przykład aby zaktualizować kolekcję elementów geograficznych, które zostały wcześniej przekazane przy użyciu interfejsu API przekazywania, umieść nową zawartość geoogrodzenia w treści żądania. Ustaw udid parametr w ścieżce na udid dane odebrane wcześniej w odpowiedzi interfejsu API przekazywania. I ustaw Content-Type nagłówek na jeden z następujących typów nośników:

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

Oto przykładowa treść żądania służąca do aktualizowania prostego elementu geoogrodzenia. Jest reprezentowana jako okrąg geometryczny przy użyciu punktu centralnego i promienia. Poniższy przykład znajduje się w GeoJSON :

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

Wcześniej przekazany geoogrodzenie miało promień 100 mln. Powyższe żądanie zaktualizuje go do 2500 mln.

Interfejs API aktualizacji danych wykonuje długotrwałe żądanie.

Limity aktualizacji danych

Należy pamiętać, że obecnie każde konto Azure Maps ma limit magazynowania danych. Po osiągnięciu limitu magazynowania wszystkie nowe wywołania interfejsu API przekazywania zwróci 409 Conflict odpowiedź na błąd http. Możesz zawsze używać interfejsu API usuwania danych , aby usunąć starą/nieużywaną zawartość i utworzyć miejsce dla nowych operacji przekazywania.

Upload Preview

Interfejs API przekazywania danych

Dotyczy: Warstwa cenowa S1.

Interfejs API przekazywania danych umożliwia obiektowi wywołującemu przekazywanie zawartości danych do usługi Azure Maps. Tego interfejsu API można użyć w scenariuszu, takim jak przekazywanie kolekcji geoogrodzeniów w GeoJSON formacie, do użycia w naszej usłudze Azure MapsGeo.

Prześlij żądanie przekazania

Aby przekazać zawartość, będziesz używać POST żądania. Treść żądania będzie zawierać dane do przekazania. dataFormatParametr zapytania będzie zawierać format danych, dataSharingLevel parametr zapytania może zawierać poziom udostępniania danych. Content-TypeNagłówek zostanie ustawiony na typ zawartości danych.

Na przykład aby przekazać kolekcję elementów geograficznych w GeoJSON formacie, należy ustawić treść żądania na zawartość geoogrodzenia. Ustaw dataFormat parametr zapytania na wartość _GEOJSON_i ustaw Content-Type nagłówek na jeden z następujących typów nośników:

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

Oto przykładowa treść żądania do przekazywania prostego geoogrodzenia reprezentowanego jako okrąg geometryczny przy użyciu punktu centralnego i promienia. Poniższy przykład znajduje się w GeoJSON :

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

Interfejs API przekazywania danych wykonuje długotrwałe żądanie.

Limity przekazywania danych

Należy pamiętać, że obecnie każde konto Azure Maps ma limit magazynowania danych. Po osiągnięciu limitu magazynowania wszystkie nowe wywołania interfejsu API przekazywania zwróci 409 Conflict odpowiedź na błąd http. Możesz zawsze używać interfejsu API usuwania danych , aby usunąć starą/nieużywaną zawartość i utworzyć miejsce dla nowych operacji przekazywania.