Data

  • Referencia
Service:
Maps
API Version:
1.0

Operations

Delete Preview

API de eliminación de datos

Se aplica a: Plan de tarifa S1.

Esta API permite al autor de la llamada eliminar un contenido de datos cargado previamente.

Puede usar esta API en un escenario como la eliminación de geovallas cargadas previamente mediante data Upload API para su uso en azure Mapas Geofencing Service. También puede usar esta API para eliminar el contenido cargado antiguo o no usado y crear espacio para el nuevo contenido.

Enviar solicitud de eliminación

Para eliminar el contenido, emitirá una solicitud en la que DELETE la ruta de acceso contendrá el de los datos que se van a udid eliminar.

Por ejemplo, para eliminar una colección de geovallas previamente cargada mediante la API de Upload, establezca el parámetro en la ruta de acceso al de los datos recibidos anteriormente en la respuesta de la API de udid udid carga.

Eliminar respuesta de datos

La API de eliminación de datos devuelve una respuesta HTTP con un cuerpo vacío, si el recurso 204 No Content de datos se eliminó correctamente.

Se devolverá una respuesta de error HTTP si no se encuentra el recurso de datos con el 400 Bad Request udid pasado.
Download Preview

API de descarga de datos

Se aplica a: Plan de tarifa S1.

Esta API permite al autor de la llamada descargar un contenido de datos cargado previamente.

Puede usar esta API en un escenario como la descarga de una colección existente de geovallas cargada anteriormente mediante data Upload API para su uso en azure Mapas Geofencing Service.

Enviar solicitud de descarga

Para descargar el contenido, usará una solicitud en la que GET la ruta de acceso contendrá la de los datos que se van a udid descargar. Opcionalmente, también puede pasar un encabezado Accept para especificar una preferencia para de la respuesta de Content-Type datos.
Por ejemplo, para descargar una colección de geovallas cargadas previamente mediante la API de Upload, establezca el parámetro en la ruta de acceso al de los datos recibidos anteriormente en la respuesta de la API de carga y establezca el encabezado en cualquiera de los siguientes tipos de udid udid Accept medios:

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

Descarga de la respuesta de datos

La API de descarga devolverá una respuesta HTTP si se encuentra el recurso de datos con el pasado, donde el cuerpo de la respuesta contendrá el contenido 200 OK udid del recurso de datos.
Se devolverá una respuesta de error HTTP si no se encuentra el recurso de datos con el 400 Bad Request udid pasado.

A continuación se muestra un cuerpo de respuesta de ejemplo para una geovalla simple representada en cargado GeoJSON anteriormente mediante Upload API: 

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

Api de lista de datos

Se aplica a: Plan de tarifa S1.

Esta API permite al autor de la llamada capturar una lista de todo el contenido cargado anteriormente mediante data Upload API.

Enviar solicitud de lista

Para enumerar todo el contenido de los datos del mapa, emitirá GET una solicitud sin parámetros adicionales.

Enumerar respuesta de datos

Data List API devuelve la lista completa de todos los datos en json formato. La respuesta contiene los detalles siguientes para cada recurso de datos:

udid: identificador de datos único para el recurso de datos.

location: la ubicación del recurso de datos. Ejecute un HTTP GET en esta ubicación para descargar los datos.

Esta es una respuesta de ejemplo que devuelve y udid de tres recursos de location datos:


{
    "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 de actualización de datos

Se aplica a: Plan de tarifa S1.

Data Update API permite al autor de la llamada actualizar un contenido de datos cargado previamente.

Puede usar esta API en un escenario como agregar o quitar geovalla hacia o desde una colección existente de geovalla. Las geovallas se cargan mediante data Upload API, para su uso en Azure Mapas Geofencing Service.

Tenga en cuenta que Update API reemplazará e invalidará el contenido de datos existente.

Enviar solicitud de actualización

Para actualizar el contenido, usará una PUT solicitud. El cuerpo de la solicitud contendrá los nuevos datos que reemplazarán a los datos existentes. El encabezado se establecerá en el tipo de contenido de los datos y la ruta de acceso contendrá el de Content-Type los datos que se van a udid actualizar.

Por ejemplo, para actualizar una colección de geovallas que se cargaron anteriormente mediante la API Upload, coloque el nuevo contenido de geovalla en el cuerpo de la solicitud. Establezca el udid parámetro en la ruta de acceso al de los datos udid recibidos anteriormente en la respuesta de la API de carga. Y establezca el Content-Type encabezado en uno de los siguientes tipos de medios:

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

Este es un cuerpo de solicitud de ejemplo para actualizar una geovalla simple. Se representa como una geometría de círculo mediante un punto central y un radio. El ejemplo siguiente se encuentra en GeoJSON :

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

La geovalla cargada anteriormente tenía un radio de 100 m. La solicitud anterior la actualizará a 500 m.

Data Update API realiza una solicitud de ejecución larga.

Límites de actualización de datos

Tenga en cuenta que actualmente cada cuenta de Azure Mapas tiene un límite de almacenamiento de datos. Una vez alcanzado el límite de almacenamiento, todas las nuevas llamadas API de carga devolverán una 409 Conflict respuesta de error HTTP. Siempre puede usar data delete API para eliminar contenido antiguo o no usado y crear espacio para nuevas cargas.
Upload Preview

API de Upload datos

Se aplica a: Plan de tarifa S1.

Data Upload API permite al autor de la llamada cargar contenido de datos en el servicio azure Mapas. Puede usar esta API en un escenario como la carga de una colección de geovallas en formato , para su uso en GeoJSON azure Mapas Geofencing Service.

Enviar Upload solicitud

Para cargar el contenido, usará una POST solicitud. El cuerpo de la solicitud contendrá los datos que se van a cargar. El Content-Type encabezado se establecerá en el tipo de contenido de los datos.

Por ejemplo, para cargar una colección de geovallas en formato, establezca el cuerpo de la solicitud GeoJSON en el contenido de la geovalla. Establezca el dataFormat parámetro de consulta en geojson y establezca el encabezado en cualquiera de los Content-Type siguientes tipos de medios:

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

El siguiente es un ejemplo de cuerpo de la solicitud para cargar una geovalla sencilla que se representa como una geometría circular mediante un punto central y un radio. El ejemplo siguiente se encuentra en GeoJSON :

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

Data Upload API realiza una solicitud de ejecución larga.

Límites de Upload datos

Tenga en cuenta que actualmente cada cuenta de Azure Mapas tiene un límite de almacenamiento de datos. Una vez alcanzado el límite de almacenamiento, todas las nuevas llamadas API de carga devolverán una 409 Conflict respuesta de error HTTP. Siempre puede usar data delete API para eliminar contenido antiguo o no usado y crear espacio para nuevas cargas.