La API EarthRanger está diseñada para brindar a cada usuario un acceso perfecto a datos y seguimiento en tiempo real.

Empezando:

Biblioteca Python: Sumérgete en nuestra biblioteca Python disponible en GitHub. Encuéntrelo aquí: https://github.com/PADAS/er-client

Ejemplos: https://github.com/PADAS/er-client/tree/main/docs/examples

Documentación completa de la API REST: una vez que haya iniciado sesión en el portal de administración EarthRanger , podrá acceder a la API REST completa, documentada aquí: https://sandbox.pamdas. org/api/v1.0/docs/index.html

Documentación interactiva: reemplace "sandbox" en la URL con el nombre de su servidor para interactuar con la API directamente: https://sandbox.pamdas.org/api/v1.0/docs/interactive/

Versión de inicio rápido súper breve

Autenticación

Usamos tokens OAuth2 para la autenticación. Puedes crear uno de larga duración aquí: https://sandbox.pamdas. org/admin/oauth2_provider/ accesstoken/

Crear una observación (rastrear ubicación o lectura de sensor)

El concepto general es que un proveedor de fuentes es un servicio que describe una o más fuentes que proporcionan información de ubicación para un sujeto. Por ejemplo, un fabricante de dispositivos de seguimiento es un proveedor de fuentes, un rastreador de rinocerontes es una fuente y el propio rinoceronte es el sujeto. Con eso en mente...

Como es típico, los encabezados API:

Autorización: Portador <token>

Aceptar: aplicación/json

Contenido-Disposición: adjunto; nombre de archivo={}

Tipo de contenido: aplicación/json

El cuerpo de una solicitud de ubicación tiene este aspecto:

{

"ubicación": {

"latitud": 47.123,

"lon":-122.123

},

"recorded_at":"2019-02-19T13: 59:15.000Z",

"manufacturer_id":" AlgunaIDUnicaParaElDispositivo",

"subject_name": "Coche 4",

"subject_type": "vehículo",

"subject_subtype": "coche",

"model_name":"Land Cruiser",

"source_type":"rastreo_dispositivo",

"adicional": {

“cualquier clave”: “cualquier valor”

}

}

Tenga en cuenta que si pasa una observación en la que el sistema no ha visto esa combinación fuente-proveedor/fabricante_id antes, creará fuentes y temas según sea necesario.

Crear un evento

Para publicar eventos, aquí hay algunos ejemplos de llamadas API:

PUBLICAR en https://sandbox.pamdas.org/api/v1.0/activity/events

Encabezados:

· Autorización: Portador xxxxxxxx

· Aceptar: aplicación/json

· Contenido-Disposición: apego; nombre de archivo = {}

· Tipo de contenido: aplicación/json

Ejemplo de cuerpo:

{

"event_type": "mist_rep",

"hora": "2019-01-17T06:18:44.056439",

"prioridad": 100,

"ubicación": {

"latitud": 47.123,

"longitud": -122,123

},

"Detalles del evento": {

"mistrep_Method": "Evacuación por aire",

" mistrep_Injury": "Malaria",

"mistrep_Symptoms": "Fiebre y sudoración",

"mistrep_Treatment": "Medicamento contra la malaria"

}

}

Tenga en cuenta que event_type y los campos para event_details corresponden a la entrada en la página Actividad > Tipos de eventos del administrador de Django.