Tabla de contenidos
Introducción
La API de Goolzoom proporciona datos sobre las delimitaciones de España. Este conjunto de datos ha sido obtenido de diversas fuentes, como el INE, el Catastro y Correos y se actualiza regularmente.
Los tipos de datos que se facilitan son a nivel nacional (España), provincial, municipal, y a nivel de códigos postales, distritos y secciones censales.
En esta página se muestran ejemplos del uso de la API para la obtención de datos sobre delimitaciones. Para la documentación completa, puedes acceder a la referencia de la API.
Tipos de delimitaciones
/v1/delimitations
Con una única consulta se obtienen los tipos de delimitaciones delimitationkey que proporciona la API.
Solicitud
curl -H "x-api-key: your_api_key" -G https://api.goolzoom.com/v1/delimitationsRespuesta
{
"delimitations": [
"Section",
"District",
"PostalCode",
"Municipality",
"Province",
"Country"
]
}
Estas claves de delimitación delimitationkey se usan para solicitar datos alfanuméricos y geometría de una determinada delimitación. Las siguientes secciones muestran cómo hacerlo.
Búsqueda por código de delimitación
/v1/delimitations/{delimitationkey}/delimitationcode/{delimitationcode}
Realiza una búsqueda por el código de delimitación
Necesariamente tiene indicarse al final de la URL uno de los siguientes tipos de datos a obtener:
-
/data: Datos alfanuméricos -
/geo: Datos geográficos
Ejemplo de solicitud:
curl -H "x-api-key: your_api_key" -G https://api.goolzoom.com/v1/delimitations/municipality/delimitationcode/28127/dataBúsqueda por latitud / longitud
/v1/delimitations/{delimitationkey}/latlng/{lat}/{lng}
Realiza una búsqueda por latitud y longitud
Necesariamente tiene indicarse al final de la URL uno de los siguientes tipos de datos a obtener:
-
/data: Datos alfanuméricos -
/geo: Datos geográficos
Ejemplo de solicitud:
curl -H "x-api-key: your_api_key" -G https://api.goolzoom.com/v1/delimitations/municipality/latlng/40.5036950636/-3.8954950000/dataDatos alfanuméricos
/data
Devuelve un Json con en nombre de la delimitación. El código de delmitación, es el código asignado por el INE.
En el siguiente ejemplo se solicitan los datos alfanuméricos /data del municipio /municipality/ con el código del INE /28127/ perteneciente a Las Rozas de Madrid.
Ejemplo de solicitud:
curl -H "x-api-key: your_api_key" -G https://api.goolzoom.com/v1/delimitations/municipality/delimitationcode/28127/dataRespuesta
{
"delimitation": {
"delimitationkey": "Municipality",
"delimitationcode": 28127,
"name": "Rozas de Madrid (Las)"
}
}Datos geográficos
/geo
Obtiene la geometría de una determinada delimitación en formato GeoJSON.
En el siguiente ejemplo se solicita la geometría /geo del municipio /municipality/ con el código del INE /28127/ perteneciente a Las Rozas de Madrid.
Ejemplo de solicitud:
curl -H "x-api-key: your_api_key" -G https://api.goolzoom.com/v1/delimitations/municipality/delimitationcode/28127/geoRespuesta
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-3.888873,
40.570675
],
[
-3.88708,
40.566423
],
[
-3.883815,
40.563835
],
[
-3.884772,
40.560806
],
[
-3.875443,
40.558827
],
[
-3.873871,
40.557542
],
[
-3.869448,
40.547413
],
[
-3.86571,
40.543441
],
[
-3.863051,
40.534637
],
[
-3.854261,
40.524973
],
[
-3.854441,
40.521372
],
[
-3.851345,
40.517665
],
[
-3.854023,
40.512029
],
[
-3.852592,
40.509746
],
[
-3.837129,
40.505891
],
[
-3.839458,
40.499365
],
[
-3.834457,
40.494055
],
[
-3.833196,
40.487627
],
[
-3.83675,
40.480826
],
[
-3.836726,
40.475124
],
[
-3.873134,
40.483517
],
[
-3.877658,
40.483483
],
[
-3.880624,
40.485334
],
[
-3.892502,
40.487671
],
[
-3.895352,
40.490752
],
[
-3.905801,
40.495
],
[
-3.910184,
40.501335
],
[
-3.913194,
40.50164
],
[
-3.923275,
40.500109
],
[
-3.923585,
40.499098
],
[
-3.926215,
40.499901
],
[
-3.926942,
40.498747
],
[
-3.933433,
40.499681
],
[
-3.935051,
40.502217
],
[
-3.934336,
40.504737
],
[
-3.935587,
40.509028
],
[
-3.93976,
40.508206
],
[
-3.940091,
40.509253
],
[
-3.937436,
40.511626
],
[
-3.940704,
40.512676
],
[
-3.942197,
40.515826
],
[
-3.939619,
40.518905
],
[
-3.9396,
40.53027
],
[
-3.947102,
40.536002
],
[
-3.949782,
40.539736
],
[
-3.9462,
40.545977
],
[
-3.945368,
40.551241
],
[
-3.942386,
40.5479
],
[
-3.939739,
40.548872
],
[
-3.936732,
40.548329
],
[
-3.934596,
40.5499
],
[
-3.934433,
40.552109
],
[
-3.932534,
40.550602
],
[
-3.931267,
40.551062
],
[
-3.932581,
40.552727
],
[
-3.93026,
40.553994
],
[
-3.932094,
40.556114
],
[
-3.930639,
40.557464
],
[
-3.932127,
40.559862
],
[
-3.929401,
40.557942
],
[
-3.920017,
40.557639
],
[
-3.909821,
40.563129
],
[
-3.908925,
40.564636
],
[
-3.905456,
40.56338
],
[
-3.895741,
40.567748
],
[
-3.890458,
40.572676
],
[
-3.885499,
40.574602
],
[
-3.888873,
40.570675
]
]
]
},
"properties": {}
}
]
}