Perfiles topográficos

Información recurso

URL
https://b5m.gipuzkoa.eus/api/2.0/profile
Formatos respuesta
JSON, Texto
Autentificación
No
Ratio limitado

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. -
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.
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.