Perfiles topográficos
Información recurso
- URL
- https://b5m.gipuzkoa.eus/api/2.0/profile
- Formatos respuesta
- JSON, Texto
- Autentificación
- No
- Ratio limitado
- Sí
API de la Infraestructura de Datos Espaciales de Gipuzkoa para la obtención de perfiles topográficos con datos altimétricos.
Parámetros de la petición
| Parámetro | Descripción | Por defecto | Requerido |
|---|---|---|---|
| coors | Colección de pares de coordenadas de un recorrido determinado, para proporcionar su perfil. Los pares de coordenadas máximas permitidas son 20. Se usa la coma como separador entre coordenadas. | - | Sí |
| srs | Sistema de referencia espacial de coordenadas (SRS), expresado en el código EPSG. Si no se especifica, el sistema lo detecta. Las SRS compatibles son EPSG:4326, EPSG:25830 y EPSG:3857. | No, el sistema lo detecta | No |
| precision | Precisión de la solicitud (de 1 a 5). Cuanto mayor sea ese valor, menos precisión tendrá, pero la respuesta será más rápida. | 1 | No |
| format | Indica el formato de la respuesta. Debe de ser: json, xml o php. | json | No |
Ejemplos
- 1. Cálculo del perfil topográfico teniendo en cuenta la línea dibujada entre tres coordenadas, en el sistema de referencia espacial EPSG:25830
-
https://b5m.gipuzkoa.eus/api/2.0/profile?coors=568326,4780573,568620,4780325,568986,4780531&srs=epsg:25830&format=json
- 2. Cálculo del perfil topográfico teniendo en cuenta la línea dibujada entre ocho coordenadas, en el sistema de referencia espacial EPSG:4326
-
https://b5m.gipuzkoa.eus/api/2.0/profile?coors=-2.42352,43.22950,-2.40086,43.20498,-2.35691,43.19046,-2.33288,43.16733,-2.34592,43.14028,-2.39056,43.12274,-2.34661,43.09316,-2.29511,43.12324&srs=epsg:4326&format=json
Respuesta
| Campo | Descripción |
|---|---|
| info | Información sobre la API: licencia, metadatos, tiempo de respuesta, mensajes, etc. |
| coordinates | Solicitud de coordenadas recibida. |
| srs | Sistema de referencia espacial en la que se ha realizado el cálculo. |
| precision | Detalle de la solicitud (de 1 a 5), tal y como se ha explicado anteriormente. |
| summary | Resumen del perfil topográfico: distancia del perfil, elevación máxima, elevación mínima, elevación media, ascenso total, descenso total y porcentaje medio de elevación. |
| elevationProfile | Datos para hacer del perfil topográfico. |
| distance | Distancia en metros del recorrido del perfil topográfico (empezando desde cero). |
| height | Altitud del recorrido del perfil topográfico en metros. |
Aviso: Si no hay datos sobre la altitud, el valor de la altitud se representará con el valor -9999. En ese caso, el valor del parámetro statuscode será «1», y se verá esta nota: «Warning: there are cases out of our range (Gipuzkoa: https://b5m.gipuzkoa.eus) where no height data exists, and the resulting height value is -9999».
Límite del servicio: se calculará un máximo de veinte pares de coordenadas.