Altimetría
Información recurso
- URL
- https://b5m.gipuzkoa.eus/api/2.0/altimetry
- Formatos respuesta
- JSON, Texto
- Autentificación
- No
- Ratio limitado
- Sí
API de altimetría de la Infraestructura de Datos Espaciales de Gipuzkoa. Los datos de altimetría se han obtenido mediante el sistema Lidar.
Parámetros de la petición
| Parámetro | Descripción | Por defecto | Requerido |
|---|---|---|---|
| coors | Par de coordenadas, entre comas. | - | Sí |
| ztype | Tipo de altitud, hay tres: o (altitud ortométrica en Alicante), oa (altitud ortométrica en Amsterdam); y e (altitud elipsoidal). | o | No |
| 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 |
| lidartype | Tipo de Lidar, hay dos: g (ground o suelo) y f (flight o vuelo). | g | No |
| year | Año en el que se recogieron los datos Lidar (2005, 2008, 2012 o 2017) | 2017 | No |
| format | Indica el formato de la respuesta. Debe de ser: txt, json o php. | txt | No |
Ejemplos
- 1. Altitud de un punto, coordenadas en el sistema EPSG:25830 pero sin introducir el parámetro srs, con la respuesta en el formato txt por defecto. El resto de parámetros serán los priorizados: tipo de altitud, ortométrico en Alicante; tipo de Lidar, suelo; y año, 2017.
-
https://b5m.gipuzkoa.eus/api/2.0/altimetry?coors=582584,4797161
- 2. Altitud de un punto, coordenadas en EPSG:4326 pero sin incluir el parámetro srs, y respuesta en formato json. Como la salida es json, el resto de parámetros se verán en la respuesta.
-
https://b5m.gipuzkoa.eus/api/2.0/altimetry?coors=-1.98146,43.32276&format=json
- 3. Altitud de un punto, tipo de z elipsoidal, coordenadas expresadas en EPSG:25830, tipo de Lidar vuelo, año 2005 y formato de salida json. Respuesta en formato json.
-
https://b5m.gipuzkoa.eus/api/2.0/altimetry?coors=582584,4797161&ztype=e&srs=epsg:25830&lidartype=f&year=2005&format=json
Respuesta
Si el formato de la respuesta es txt, la respuesta será un número con dos decimales que expresará en metros la altitud del punto solicitado.
Si el formato de la respuesta no es txt, se indicará así:
| Campo | Descripción |
|---|---|
| height | Altitud del punto solicitado en metros. En caso de no disponer de datos la respuesta será -9999 (por ejemplo, cuando el punto se encuentra fuera del ámbito de Gipuzkoa). |
| info | Licencia y metadatos sobre los datos de la altitud. |
Aviso: si no hay datos sobre la altitud, la altitud se representará con el valor -9999.