Descarga de geometrías de elementos geográficos

Servicios web

Documentación sobre la funcionalidad Descarga de geometrías de elementos geográficos disponible a través del webservice HTTP-JSON/XML de la plataforma CERCALIA.

La URL base a utilizar es:

* Clave de seguridad. Es la misma KEY que para la API de mapas de Cercalia

Las peticiones HTTP se pueden enviar en GET o POST
Las respuestas son en formato JSON / XML

Obtener la geometría (WKT) de un municipio, código postal o ZOI

Petición para obtener la geometría (WKT) de un municipio, código postal o un ZOI (polígonos de una categoría de puntos de interés*).

* Actualmente disponible las Secciones Censales y las parcelas SIGPAC.

PETICIÓN

Ejemplo de petición:

&cmd=geoment&poic=D00_43157_0_0_130_66_2&tolerance=0&cs=4326

Donde:

  • cmd=geoment Valores fijos
  • munc / pcode / poic= ID de municipio / CP / ID de punto de interés del que se desea recuperar la geometría
  • ctryc= código de país ISO 3 dígitos. OBLIGATORIO para &pcode=
  • tolerance= generalización del polígono, en metros. Si 0, se devuelve el polígono original
  • cs=4326 sistema de coordenadas en el que se devolverá la geometría. 4326 = geográficas grados decimales

Ejemplo:

  • Municipio de Zaragoza: cmd=geoment&munc=ESP502973&tolerance=0&cs=4326
  • Código Postal 08025: cmd=geoment&pcode=08025&ctryc=ESP&tolerance=0&cs=4326
  • Polígono de Sección Censal: cmd=geoment&poic=DC00SC2807918002&tolerance=0&cs=4326
  • Parcela SIGPAC: cmd=geoment&poic=D00_43157_0_0_130_66_2&tolerance=0&cs=4326

RESPUESTA

<cercalia cmd="geoment" version="1">
   <poi category_id="D00SIGPAC" geometry="Z" id="D00_43157_0_0_130_66_2" subcategory_id="-1">
      <name>43157:0:0:130:66:2</name>
      <info>43157|IM|0.023681334|PARCIAL|12</info>
      <ge>
         <city id="ESP17240012883186">Tortosa</city>
         <municipality id="ESP431554">Tortosa</municipality>
         <subregion id="ESP43">Tarragona</subregion>
         <region id="ESPCAT">Catalunya</region>
         <country id="ESP">España</country>
      </ge>
      <coord x="57792" y="4953695"/>
      <wkt tolerance="0.0">
         MULTIPOLYGON(((0.519285 40.791313,0.519251 40.791444,0.519088 40.791424,0.519055 40.79142,0.519098 40.791295,0.519285 40.791313)))
      </wkt>
   </poi>
   <server>http://cercalia-tomcat-lbs-instance1:8080</server>
</cercalia>

El XML de respuesta de Cercalia contiene el elemento WKT con la geometría expresada en "Well-known Text Representation for Geometry".

 

"Well-known Text Representation for Geometry" es un estándar para el intercambio de geometrías definido por Open Geospatial Consortium. La siguiente tabla muestra ejemplos de este formato:

Geometry Type Text Literal Representation Comment
Point 'POINT (10 10)' a Point
LineString 'LINESTRING ( 10 10, 20 20, 30 40)' a LineString with 3 points
Polygon 'POLYGON ((10 10, 10 20, 20 20, 20 15, 10 10))' a Polygon with 1 exteriorRing and 0 interiorRings
Multipoint 'MULTIPOINT (10 10, 20 20)' a MultiPoint with 2 points
MultiLineString 'MULTILINESTRING ((10 10, 20 20), (15 15, 30 15))' a MultiLineString with 2 linestrings
MultiPolygon 'MULTIPOLYGON ( ((10 10, 10 20, 20 20, 20 15, 10 10)), ((60 60, 70 70, 80 60, 60 60 ) ))' a MultiPolygon with 2 polygons
GeomCollection 'GEOMETRYCOLLECTION (POINT (10 10), POINT (30 30), LINESTRING (15 15, 20 20))' a GeometryCollection consisting of 2 Point values and a LineString value