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 / subregc / poic= ID de municipio / CP / ID de Provincia / 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
  • Provincia de Madrid: cmd=geoment&subregc=ESP28&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

Obtener la geometría (WKT) de una calle

Petición para obtener la geometría (WKT) de una calle, filtrando de forma opcional por radio o por código postal.

PETICIÓN

Ejemplo de petición:

&cmd=geoment&rqge=st&mo=37.767951111,-3.790683886&mocs=gdd&cs=4326&tolerance=0&stc=&pcode=23004&rad=500&buffer=

 

Donde:

  • cmd=geoment Valors fijo
  • rqge=st Valor fijo
  • mo=Y,X (opcional si stc informado)
  • mocs=gdd sistema en el que se han informado las coordenadas
  • cs=4326 sistema de coordenadas en el que se devolverá la geometría. 4326 = geográficas grados decimales
  • tolerance= generalización de las polilíneas, en metros. Si 0, se devuelve el polígono original
  • stc= ID de calle (opcional si mo informado). Este parámetro se prioriza por encima del mo=
  • pcode= código postal (opcional) -> si se indica, se devuelven los tramos de la calle del código postal.
  • rad= radio (opcional) -> se devuelven los tramos que están dentro o intersectan el radio. Este parámetro se prioriza por encima del pcode=. se recomienda utilizar solo con el parámetro &mo=
  • buffer= devuelve el polígono alrededor del eje viario correspondiente al buffer, en metros, indicado (opcional).

RESPUESTA

<cercalia cmd="geoment" version="1">
    <ge id="ESP080193000092155" type="st">
        <geometry>
            <wkt>
                MULTILINESTRING((2.19227720000266 41.4045097000002,2.1939068000009 41.4049257000016),(2.19031069999947 41.4042851999981,2.19192439999684 41.4046852000012),(2.19185739999579 41.4044059000003,2.19227720000266 41.4045097000002),(2.18883240000163 41.4036521999978,2.19058060000338 41.4040945999973),(2.19058060000338 41.4040945999973,2.19185739999579 41.4044059000003),(2.19192439999684 41.4046852000012,2.19351620000183 41.4050827000025),(2.18855479999843 41.4038593999969,2.19031069999947 41.4042851999981))
            </wkt>
        </geometry>
    </ge>
</cercalia>

 

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