Data

Operations

Delete Preview

API zum Löschen von Daten

Gilt für: Tarif S1.

Diese API ermöglicht dem Aufrufer das Löschen eines zuvor hochgeladenen Daten Inhalts.

Sie können diese API in einem Szenario wie dem Entfernen von zuvor hochgeladenen Geofencing mithilfe der API zum Hochladen von Daten für den Azure Maps Geofencing-Dienstverwenden. Sie können diese API auch verwenden, um alte/nicht verwendete Hochgeladene Inhalte zu löschen und Speicherplatz für neue Inhalte zu schaffen.

Löschanforderung senden

Um ihren Inhalt zu löschen, geben Sie eine DELETE Anforderung aus, bei der der Pfad den udid der zu löschenden Daten enthalten soll.

Wenn Sie z. b. eine Sammlung von geozäunen löschen möchten, die zuvor mit der Upload-API hochgeladen wurden, legen Sie den- udid Parameter im Pfad auf den udid der zuvor in der Upload-API-Antwort empfangenen Daten fest.

Löschen von Daten Antworten

Die Data Delete-API gibt eine HTTP- 204 No Content Antwort mit einem leeren Text zurück, wenn die Daten Ressource erfolgreich gelöscht wurde.

Eine HTTP- 400 Bad Request Fehler Antwort wird zurückgegeben, wenn die Daten Ressource mit dem-Wert udid nicht gefunden wird.

Download Preview

Daten Download-API

Gilt für: Tarif S1.

Diese API ermöglicht dem Aufrufer das Herunterladen eines zuvor hochgeladenen Daten Inhalts.

Sie können diese API in einem Szenario verwenden, z.b. das Herunterladen einer vorhandenen Sammlung von zuvor hochgeladenen Geofence mithilfe der API zum Hochladen von Daten für die Verwendung in unserem Azure Maps Geofencing-Dienst.

Download Anforderung übermitteln

Zum Herunterladen Ihrer Inhalte verwenden Sie eine GET Anforderung, bei der der Pfad den der herunter zuladenden Daten enthalten soll udid . Optional können Sie auch einen-Header übergeben Accept , um eine Einstellung für die Content-Type der Daten Antwort anzugeben.
Wenn Sie z. b. eine Sammlung von geozäunen herunterladen möchten, die zuvor mit der Upload-API hochgeladen wurden, legen Sie den- udid Parameter im Pfad auf den udid der zuvor in der Upload-API-Antwort empfangenen Daten fest, und legen Sie den- Accept Header auf einen der folgenden Medientypen fest:

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

Daten Antwort herunterladen

Die Download-API gibt eine HTTP- 200 OK Antwort zurück, wenn die Daten Ressource mit dem über gebenen udid gefunden wird, wobei der Antworttext den Inhalt der Daten Ressource enthält.
Eine HTTP- 400 Bad Request Fehler Antwort wird zurückgegeben, wenn die Daten Ressource mit dem-Wert udid nicht gefunden wird.

Im folgenden finden Sie einen Beispiel Antworttext für einen einfachen Geofence befindet, GeoJSON der zuvor mit der Upload-API in hochgeladen wurde:

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

Data List-API

Gilt für: Tarif S1.

Diese API ermöglicht dem Aufrufer das Abrufen einer Liste aller zuvor hochgeladenen Inhalte mithilfe der API zum Hochladen von Daten.

Anforderung zum Senden einer Liste

Um den gesamten Inhalt der Kartendaten aufzulisten, geben Sie eine GET Anforderung ohne zusätzliche Parameter aus.

Daten Antwort auflisten

Die Data List-API gibt die vollständige Liste aller Daten im- json Format zurück. Die Antwort enthält die folgenden Details für die einzelnen Datenressourcen:

UDID: die eindeutige Daten-ID für die Daten Ressource.

Location: der Speicherort der Daten Ressource. Führen Sie ein HTTP GET an diesem Speicherort aus, um die Daten herunterzuladen.

Im folgenden finden Sie eine Beispiel Antwort, die die udid und location von 3 Datenressourcen zurückgibt:


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

Datenaktualisierungs-API

Gilt für: Tarif S1.

Mit der Data Update-API kann der Aufrufer einen zuvor hochgeladenen Dateninhalt aktualisieren.

Sie können diese API in einem Szenario wie das Hinzufügen oder Entfernen von geozäunen zu einer vorhandenen Sammlung von geozäunen verwenden. Geozäune werden mithilfe der API zum Hochladen von Datenfür die Verwendung im Azure Maps Geofencing-Diensthochgeladen.

Beachten Sie, dass durch die Update-API der vorhandene Dateninhalt ersetzt und über schrieben wird.

Aktualisierungs Anforderung senden

Um ihren Inhalt zu aktualisieren, verwenden Sie eine PUT Anforderung. Der Anforderungs Text enthält die neuen Daten, durch die die vorhandenen Daten ersetzt werden. Der Content-Type -Header wird auf den Inhaltstyp der Daten festgelegt, und der Pfad enthält die udid der zu aktualisierenden Daten.

Um z. b. eine Sammlung von geozäunen zu aktualisieren, die zuvor mit der Upload-API hochgeladen wurden, platzieren Sie den neuen Geofence befindet-Inhalt im Anforderungs Text. Legen Sie den- udid Parameter im Pfad auf den udid der zuvor in der Upload-API-Antwort empfangenen Daten fest. Und legen Sie den- Content-Type Header auf einen der folgenden Medientypen fest:

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

Im folgenden finden Sie einen Beispiel Anforderungs Text zum Aktualisieren eines einfachen Geofence. Es wird als Kreis Geometrie dargestellt, wobei ein Mittelpunkt und ein RADIUS verwendet werden. Das folgende Beispiel befindet sich in GeoJSON :

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

Der zuvor hochgeladene Geofence befindet enthielt einen Radius von 100 Mio. Die obige Anforderung aktualisiert Sie auf 500 Mio.

Die datenaktualisierungs-API führt eine Anforderung mit langer Ausführungszeitaus.

Daten Aktualisierungs Limits

Bitte beachten Sie, dass für jedes Azure Maps Konto derzeit ein Datenspeicher Limitgilt. Sobald das Speicherlimit erreicht ist, geben alle neuen Aufrufe der Upload-API eine 409 Conflict HTTP-Fehler Antwort zurück. Sie können immer die Data Delete-API verwenden, um alten/nicht verwendeten Inhalt zu löschen und Speicherplatz für neue Uploads zu schaffen.

Upload Preview

API zum Hochladen von Daten

Gilt für: Tarif S1.

Die API zum Hochladen von Daten ermöglicht dem Aufrufer das Hochladen von Dateninhalt in den Azure Maps-Dienst. Sie können diese API in einem Szenario wie dem Hochladen einer Sammlung von geozäunen im- GeoJSON Format für die Verwendung in unserem Azure Maps Geofencing-Dienstverwenden.

Uploadanforderung senden

Zum Hochladen Ihrer Inhalte verwenden Sie eine POST Anforderung. Der Anforderungs Text enthält die Daten, die hochgeladen werden sollen. Der dataFormat Abfrage Parameter enthält das Format für die Daten dataSharingLevel . der Abfrage Parameter kann die Freigabe Ebene für die Daten enthalten. Der- Content-Type Header wird auf den Inhaltstyp der Daten festgelegt.

Wenn Sie z. b. eine Sammlung von geozäunen im-Format hochladen möchten GeoJSON , legen Sie den Anforderungs Text auf den Geofence befindet-Inhalt fest. Legen dataFormat Sie den Abfrage Parameter auf _geojson_fest, und legen Sie den- Content-Type Header auf einen der folgenden Medientypen fest:

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

Im folgenden finden Sie einen Beispiel Anforderungs Text zum Hochladen eines einfachen Geofence, der als Kreis Geometrie mithilfe eines Mittelpunkts und eines RADIUS dargestellt wird. Das folgende Beispiel befindet sich in GeoJSON :

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

Die API zum Hochladen von Daten führt eine Anforderung mit langer Ausführungszeitaus.

Daten Upload-Limits

Bitte beachten Sie, dass für jedes Azure Maps Konto derzeit ein Datenspeicher Limitgilt. Sobald das Speicherlimit erreicht ist, geben alle neuen Aufrufe der Upload-API eine 409 Conflict HTTP-Fehler Antwort zurück. Sie können immer die Data Delete-API verwenden, um alten/nicht verwendeten Inhalt zu löschen und Speicherplatz für neue Uploads zu schaffen.