Web services
POIs API documentation, available via HTTP-JSON/XML service.
URL base service:
- HTTP requests in GET or POST
- Response in JSON / XML format
Get the nearest POIs
Request
Example:
https://lb.cercalia.com/services/json?cmd=prox&mo=40.3691,-3.589&mocs=gdd&rqpoicats=C001&num=2&rad=10000&key=YOUR_API_KEY
Where:
| Paramaeter | Description |
|---|---|
mo | Search center, format: lat, lon |
mocs | gdd Coordinate system (gdd = geographical - lat, long) |
rqpoicats | List of POI categories (separated by commas) to be searched, ordered by proximity |
num | Maximum number of points to return (max: 1000) |
rad | Maximum radius (in meters) |
Response
{
"cercalia": {
"cmd": "prox",
"version": "1",
"proximity": {
"center": "-3.58900312,40.36909901",
"num": "2",
"rad": "10000",
"type": "poi",
"poilist": {
"num": "2",
"poi": [
{
"category_id": "C001",
"dist": "176",
"geometry": "P",
"id": "C001#724007000492000",
"pos": "1",
"subcategory_id": "-1",
"name": {
"$valor": "Repsol SuperCOR Stop&Go La Superestación"
},
"info": {
"$valor": "Repsol SuperCOR Stop&Go La Superestación. 28051 Madrid. Tel: +(34)-(914)-860484"
},
"ge": {
"street": {
"id": "UNKNOWN"
},
"city": {
"id": "UNKNOWN",
"$valor": "Madrid"
},
"municipality": {
"id": "ESP280796",
"$valor": "Madrid"
},
"subregion": {
"id": "ESP28",
"$valor": "Madrid"
},
"region": {
"id": "ESPMAD",
"$valor": "Comunidad de Madrid"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "-3.58801498",
"y": "40.36769732"
}
},
{
"category_id": "C001",
"dist": "241",
"geometry": "P",
"id": "C001#724009002370834",
"pos": "2",
"subcategory_id": "-1",
"name": {
"$valor": "ÁREA 117"
},
"info": {
"$valor": "ÁREA 117. Avenida Del Mediterráneo, Km11.9, 28051 Madrid. Tel: +(34)-(692)-982944. Web: www.area117.es"
},
"ge": {
"housenumber": {
"$valor": "Km11.9"
},
"street": {
"id": "UNKNOWN",
"$valor": "Avenida Del Mediterráneo"
},
"city": {
"id": "UNKNOWN",
"$valor": "Madrid"
},
"municipality": {
"id": "ESP280796",
"$valor": "Madrid"
},
"subregion": {
"id": "ESP28",
"$valor": "Madrid"
},
"region": {
"id": "ESPMAD",
"$valor": "Comunidad de Madrid"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "-3.58657767",
"y": "40.36795155"
}
}
]
}
},
"server": {
"$valor": "ws.cercalia.com"
},
"instance": {
"$valor": "http://cercalia-lbs-both-lines"
}
}
}
Where:
| Parameter | Description |
|---|---|
dist | Projected straight-line distance (center point vs POI), in meters |
pos | Proximity order (from closest to least) |
name | POI name |
info | POI additional info |
Get the neares POIs, using routing
Request
Example:
https://lb.cercalia.com/services/json?cmd=prox&mo=40.3691,-3.589&rqpoicats=C001&num=2&&weight=time&mocs=gdd&inverse=0&key=YOUR_API_KEY
Where:
| Parameter | Description |
|---|---|
mo | Search center, format: lat, lon |
mocs | gdd Coordinate system (gdd = geographical - lat, long) |
rqpoicats | List of POI categories (separated by commas) to be searched, ordered by proximity |
num | Maximum number of points to return (optional) |
rad | Maximum radius, in meters (optional) |
weight | Route type: |
time | (faster) |
distance | (shortest) |
money | (faster, avoiding tolls) |
realtime | (quickest, considering real time traffic data) |
iweight | realtime Use this parameter to obtain the time of the route, based on the current traffic state. |
inverse | If 0 Route times are from the center to the point list, 1 Route times are from the list of points to the center |
Routing based on departure time:
| Parameter | Description |
|---|---|
weight | Route type: |
sptime | (quickest, based on departure time) |
spmoney | (quickest, based on departure time and avoiding toll roads) |
departuretime | Departure date and time, in ISO 8601 format. UTC time example: 2019-10-16T07:30:12Z. Mandatory to include the &weight= parameter. |
Response
{
"cercalia": {
"cmd": "prox",
"version": "1",
"proximity": {
"center": "-3.58900312,40.36909901",
"inverse": "0",
"num": "2",
"type": "poi",
"weight": "time",
"poilist": {
"num": "2",
"poi": [
{
"category_id": "C001",
"dist": "241",
"geometry": "P",
"id": "C001#724009002370834",
"pos": "1",
"routedist": "245",
"routerealtime": "54711",
"routetime": "54711",
"routeweight": "54711",
"subcategory_id": "-1",
"name": {
"$valor": "ÁREA 117"
},
"info": {
"$valor": "ÁREA 117. Avenida Del Mediterráneo, Km11.9, 28051 Madrid. Tel: +(34)-(692)-982944. Web: www.area117.es"
},
"ge": {
"housenumber": {
"$valor": "Km11.9"
},
"street": {
"id": "UNKNOWN",
"$valor": "Avenida Del Mediterráneo"
},
"city": {
"id": "UNKNOWN",
"$valor": "Madrid"
},
"municipality": {
"id": "ESP280796",
"$valor": "Madrid"
},
"subregion": {
"id": "ESP28",
"$valor": "Madrid"
},
"region": {
"id": "ESPMAD",
"$valor": "Comunidad de Madrid"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "-3.58657767",
"y": "40.36795155"
}
},
{
"category_id": "C001",
"dist": "176",
"geometry": "P",
"id": "C001#724007000492000",
"pos": "2",
"routedist": "5985",
"routerealtime": "385184",
"routetime": "385184",
"routeweight": "385184",
"subcategory_id": "-1",
"name": {
"$valor": "Repsol SuperCOR Stop&Go La Superestación"
},
"info": {
"$valor": "Repsol SuperCOR Stop&Go La Superestación. 28051 Madrid. Tel: +(34)-(914)-860484"
},
"ge": {
"street": {
"id": "UNKNOWN"
},
"city": {
"id": "UNKNOWN",
"$valor": "Madrid"
},
"municipality": {
"id": "ESP280796",
"$valor": "Madrid"
},
"subregion": {
"id": "ESP28",
"$valor": "Madrid"
},
"region": {
"id": "ESPMAD",
"$valor": "Comunidad de Madrid"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "-3.58801498",
"y": "40.36769732"
}
}
]
}
},
"server": {
"$valor": "ws.cercalia.com"
},
"instance": {
"$valor": "http://cercalia-lbs-both-lines"
}
}
}
Where:
| Parameter | Description |
|---|---|
dist | Projected straight-line distance (center point vs POI), in meters. |
routedist | Route distance (center point vs POI), in meters. |
routetime | Route time (center point vs POI), in milliseconds. |
Get the POIs along a route
Request
Example:
https://lb.cercalia.com/services/json?cmd=geom&routeweight=time&tolerance=5&routeid=2767920,2778988|0.6167333,0.6414299&getpoicats=C001&buffer=50&key=YOUR_API_KEY
Where:
| Parameter | Description |
|---|---|
routeid | Route ID, from a cmd=route request (route IDs are available during some hours). |
routeweight | Route type used in the previous route request (cmd=route). Ex: time. |
getpoicats | POIs categories to search. |
buffer | Buffer distance to be used in the POIs search, in meters (example: 50). |
tolerance | Route polyline simplification, in meters. Default: 100 meters. |
Response
{
"cercalia": {
"cmd": "geom",
"version": "1",
"getpoicats": {
"poicats": {
"poicat": [
{
"$valor": "C001"
}
]
},
"poilist": {
"num": "1",
"poi": [
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009007947185",
"subcategory_id": "-1",
"name": {
"$valor": "BP Rio Grande"
},
"info": {
"$valor": "BP Rio Grande. 29570 Cártama. Tel: +(34)-(952)-118249. Web: www.bp.com"
},
"ge": {
"street": {
"id": "UNKNOWN"
},
"city": {
"id": "UNKNOWN",
"$valor": "Cártama"
},
"municipality": {
"id": "ESP290385",
"$valor": "Cártama"
},
"subregion": {
"id": "ESP29",
"$valor": "Málaga"
},
"region": {
"id": "ESPAND",
"$valor": "Andalucía"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "-4.70090185",
"y": "36.72014909"
}
}
]
}
},
"server": {
"$valor": "ws.cercalia.com"
},
"instance": {
"$valor": "http://cercalia-lbs-both-lines"
}
}
}
Get the POIs inside a map extension
Request
Example:
https://lb.cercalia.com/services/json?cmd=map&map=0&extent=42.144102962,-0.414886914|42.139342832,-0.407628526&cs=gdd&getpoicats=D00GAS&key=YOUR_API_KEY
Where:
| Parameter | Description |
|---|---|
map | 0/1 No include / include a static map (image). If only POIs list is needed, use map=0 for faster response. |
cs | gdd Coordinate system (gdd = geographical - lat, long). |
extent | Map extension: Y,X |
getpoicats | POIs categories to search. |
Response
{
"cercalia": {
"cmd": "map",
"version": "1",
"proximity": {
"op": "3"
},
"map": {
"smap": "0",
"style": "default",
"img": {
"center": "-0.41125772,42.14172294",
"format": "gif",
"height": "250",
"href": "",
"scale": "3",
"width": "350",
"extent": {
"coord": [
{
"x": "-0.42165123",
"y": "42.14724499"
},
{
"x": "-0.40085523",
"y": "42.13619373"
}
]
}
},
"label": {
"op": "1",
"pt": "-0.41125772,42.14172294"
},
"poicats": {},
"shapes": {},
"getpoicats": {
"poicat": [
{
"$valor": "D00GAS"
}
],
"poilist": {
"poi": [
{
"category_id": "D00GAS",
"geometry": "P",
"id": "D00GAS#D00IDEESS1314I",
"subcategory_id": "REP",
"name": {
"$valor": "REPSOL"
},
"info": {
"$valor": "I|AVENIDA PAZ LA, 33|HUESCA|Huesca|HUESCA|22004|L-D: 24H|P|1.609|1.469|||||0.0||0.0||2024-12-18T07:15:12"
},
"ge": {
"city": {
"id": "UNKNOWN",
"$valor": "Huesca"
},
"municipality": {
"id": "ESP221259",
"$valor": "Aragón"
},
"subregion": {
"id": "ESP22",
"$valor": "Huesca"
},
"region": {
"id": "ESPARA",
"$valor": "Aragón"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "-0.41300045",
"y": "42.14263886"
},
"pixels": {
"x": "146",
"y": "105"
}
},
{
"category_id": "D00GAS",
"geometry": "P",
"id": "D00GAS#D00IDEESS1286D",
"subcategory_id": "REP",
"name": {
"$valor": "REPSOL"
},
"info": {
"$valor": "D|CALLE COSO ALTO, 65|HUESCA|Huesca|HUESCA|22003|L-V: 07:00-15:00|P|1.589|1.459|||||0.0||0.0||2024-12-18T07:15:12"
},
"ge": {
"city": {
"id": "UNKNOWN",
"$valor": "Huesca"
},
"municipality": {
"id": "ESP221259",
"$valor": "Aragón"
},
"subregion": {
"id": "ESP22",
"$valor": "Huesca"
},
"region": {
"id": "ESPARA",
"$valor": "Aragón"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "-0.41050314",
"y": "42.14119478"
},
"pixels": {
"x": "187",
"y": "136"
}
}
]
}
}
},
"server": {
"$valor": "ws.cercalia.com"
},
"instance": {
"$valor": "http://cercalia-lbs-both-lines"
}
}
}
Get the POIs inside a map extension, with zoom filtering
Request
Example:
https://lb.cercalia.com/services/json?cmd=map&map=0&extent=42.144102962,-0.414886914|42.139342832,-0.407628526&cs=gdd&mocs=gdd&gpoicats=D00GAS&key=YOUR_API_KEY
Where:
map=0/1 No include / include a static map (image). If only need POIs list, use map=0 for faster responsecs=gdd Coordinate system (gdd = geographical - lat, long)extent= map extension: Y,X|Y,X. Upper-left corner | Lower-right cornergetpoicats= POIs categories to searchgridsize= (optional) Grid size used for POIs zoom filtering (higher value = more filtering).
Response
{
"cercalia": {
"cmd": "map",
"version": "1",
"proximity": {
"op": "3"
},
"map": {
"smap": "0",
"style": "default",
"img": {
"center": "-0.41125772,42.14172294",
"format": "gif",
"height": "250",
"href": "",
"scale": "3",
"width": "350",
"extent": {
"coord": [
{
"x": "-0.42165123",
"y": "42.14724499"
},
{
"x": "-0.40085523",
"y": "42.13619373"
}
]
}
},
"label": {
"op": "1",
"pt": "-0.41125772,42.14172294"
},
"poicats": {},
"shapes": {},
"gpoicats": {
"gridsize": "100",
"poicat": [
{
"$valor": "D00GAS"
}
],
"poilist": {
"poi": [
{
"category_id": "D00GAS",
"id": "D00GAS#D00IDEESS1314I",
"subcategory_id": "REP",
"name": {
"$valor": "REPSOL"
},
"info": {
"$valor": "I|AVENIDA PAZ LA, 33|HUESCA|Huesca|HUESCA|22004|L-D: 24H|P|1.609|1.469|||||0.0||0.0||2024-12-18T07:15:12"
},
"ge": {
"municipality": {
"id": "ESP221259"
}
},
"coord": {
"x": "-0.41300045",
"y": "42.14263886"
},
"pixels": {
"x": "146",
"y": "105"
}
},
{
"category_id": "D00GAS",
"id": "D00GAS#D00IDEESS1286D",
"subcategory_id": "REP",
"name": {
"$valor": "REPSOL"
},
"info": {
"$valor": "D|CALLE COSO ALTO, 65|HUESCA|Huesca|HUESCA|22003|L-V: 07:00-15:00|P|1.589|1.459|||||0.0||0.0||2024-12-18T07:15:12"
},
"ge": {
"municipality": {
"id": "ESP221259"
}
},
"coord": {
"x": "-0.41050314",
"y": "42.14119478"
},
"pixels": {
"x": "187",
"y": "136"
}
}
]
}
}
},
"server": {
"$valor": "ws.cercalia.com"
},
"instance": {
"$valor": "http://cercalia-lbs-both-lines"
}
}
}
Get the POIs inside a polygon
Request
Example:
https://lb.cercalia.com/services/json?cmd=prox&rqpoicats=C001&cs=4326&wkt=POLYGON((2.149028778076172%2041.39586980544921,2.146625518798828%2041.41930231731321,2.1816444396972656%2041.41981722266227,2.1813011169433594%2041.398187683195694,2.149028778076172%2041.39586980544921))&key=YOUR_API_KEY
Where:
| Parameter | Description |
|---|---|
cs | 4326 Coordinate system (gdd = 4326 -> lat, long). |
wkt | Polygon, in WKT format. |
rqpoicats | POIs categories to search. |
Response
"cercalia": {
"cmd": "prox",
"version": "1",
"proximity": {
"buffer": "0.0",
"cs": "4326",
"tolerance": "0.0",
"type": "poi",
"wkt": "POLYGON((2.149028778076172 41.39586980544921,2.146625518798828 41.41930231731321,2.1816444396972656 41.41981722266227,2.1813011169433594 41.398187683195694,2.149028778076172 41.39586980544921))",
"poilist": {
"num": "9",
"poi": [
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009007934310",
"subcategory_id": "-1",
"name": {
"$valor": "Repsol Virgen Montserrat"
},
"info": {
"$valor": "Repsol Virgen Montserrat. Avinguda de la Mare de Déu de Montserrat, 87, 08024 Barcelona. Tel: +(34)-(932)-846895. Web: www.repsol.com"
},
"ge": {
"housenumber": {
"$valor": "87"
},
"street": {
"id": "UNKNOWN",
"$valor": "Avinguda de la Mare de Déu de Montserrat"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.16697003",
"y": "41.41551638"
}
},
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009033832084",
"subcategory_id": "-1",
"name": {
"$valor": "Cepsa Gaudí"
},
"info": {
"$valor": "Cepsa Gaudí. Avinguda de Gaudí, 1, 08025 Barcelona. Tel: +(34)-(934)-368678. Web: www.repsol.com"
},
"ge": {
"housenumber": {
"$valor": "1"
},
"street": {
"id": "UNKNOWN",
"$valor": "Avinguda de Gaudí"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.17421943",
"y": "41.40487843"
}
},
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009007937627",
"subcategory_id": "-1",
"name": {
"$valor": "Galp Sant Antoni Maria Claret"
},
"info": {
"$valor": "Galp Sant Antoni Maria Claret. Carrer de Sant Antoni Maria Claret, 2, 08041 Barcelona. Tel: +(34)-(934)-369116. Web: www.galpenergia.com"
},
"ge": {
"housenumber": {
"$valor": "2"
},
"street": {
"id": "UNKNOWN",
"$valor": "Carrer de Sant Antoni Maria Claret"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.18021119",
"y": "41.41584773"
}
},
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009007944045",
"subcategory_id": "-1",
"name": {
"$valor": "Cerdeña"
},
"info": {
"$valor": "Cerdeña. Carrer de Sardenya, 225, 08013 Barcelona"
},
"ge": {
"housenumber": {
"$valor": "225"
},
"street": {
"id": "UNKNOWN",
"$valor": "Carrer de Sardenya"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.1773276",
"y": "41.40014387"
}
},
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009007931669",
"subcategory_id": "-1",
"name": {
"$valor": "Repsol San Juan-Diagonal"
},
"info": {
"$valor": "Repsol San Juan-Diagonal. Plaça del Mossèn Jacint Verdaguer, 08037 Barcelona. Web: www.repsol.com"
},
"ge": {
"street": {
"id": "UNKNOWN",
"$valor": "Plaça del Mossèn Jacint Verdaguer"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.16966497",
"y": "41.3993322"
}
},
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009005184853",
"subcategory_id": "-1",
"name": {
"$valor": "Repsol Legalitat"
},
"info": {
"$valor": "Repsol Legalitat. Carrer de la Legalitat, 59, 08024 Barcelona. Tel: +(34)-(932)-195641. Web: www.repsol.com"
},
"ge": {
"housenumber": {
"$valor": "59"
},
"street": {
"id": "UNKNOWN",
"$valor": "Carrer de la Legalitat"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.16166098",
"y": "41.40873345"
}
},
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009034307011",
"subcategory_id": "-1",
"name": {
"$valor": "Repsol Piserra"
},
"info": {
"$valor": "Repsol Piserra. Carrer de València, 503, 08013 Barcelona. Tel: +(34)-(932)-326760. Web: www.disagrupo.es"
},
"ge": {
"housenumber": {
"$valor": "503"
},
"street": {
"id": "UNKNOWN",
"$valor": "Carrer de València"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.17964526",
"y": "41.40523689"
}
},
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009007938733",
"subcategory_id": "-1",
"name": {
"$valor": "Gratsa"
},
"info": {
"$valor": "Gratsa. Passeig de Maragall, 33, 08041 Barcelona. Tel: +(34)-(934)-547418"
},
"ge": {
"housenumber": {
"$valor": "33"
},
"street": {
"id": "UNKNOWN",
"$valor": "Passeig de Maragall"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.18046272",
"y": "41.41496187"
}
},
{
"category_id": "C001",
"geometry": "P",
"id": "C001#724009007939633",
"subcategory_id": "-1",
"name": {
"$valor": "Repsol GEDS"
},
"info": {
"$valor": "Repsol GEDS. Carrer de Provença, 309, 08037 Barcelona. Tel: +(34)-(934)-580811. Web: www.repsol.com"
},
"ge": {
"housenumber": {
"$valor": "309"
},
"street": {
"id": "UNKNOWN",
"$valor": "Carrer de Provença"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.16643104",
"y": "41.39866932"
}
}
]
}
},
"server": {
"$valor": "ws.cercalia.com"
},
"instance": {
"$valor": "http://cercalia-lbs-both-lines"
}
}
}
Weather forecast location
Get the meteo forecast, from a coordinate. The weather forecast is available for all the world, but with more or less density depending on the country.
Request
Example:
https://lb.cercalia.com/services/json?cmd=prox&rqpoicats=D00M05&mocs=gdd&mo=41.39818,2.1490287&key=YOUR_API_KEY
Where:
| Parameter | Description |
|---|---|
mocs | gdd Coordinate system (gdd = geographical - lat,lon). |
mo | Search center, format: lat,lon |
rqpoicats | D00M05 Meteo info category |
Response
{
"cercalia": {
"cmd": "prox",
"version": "1",
"proximity": {
"center": "2.14903067,41.39818231",
"num": "1",
"type": "poi",
"poilist": {
"num": "1",
"poi": [
{
"category_id": "D00M05",
"dist": "2082",
"geometry": "P",
"id": "D00M05#D00M0508019",
"pos": "1",
"subcategory_id": "012",
"name": {
"$valor": "Barcelona"
},
"info": {
"$valor": "2024-12-18T06:26:07|2024-12-18|0|0|||12|12|5|15|16|7|2024-12-19|10|0|||13|12|20|30|20|11|2024-12-20|0|0|||12|12|16|8|2024-12-21|15|1200|13|15|7|2024-12-22|0||11|16|10|2024-12-23|20|1000|13|16|9"
},
"ge": {
"street": {
"id": "UNKNOWN"
},
"city": {
"id": "UNKNOWN",
"$valor": "Barcelona"
},
"municipality": {
"id": "ESP080193",
"$valor": "Barcelona"
},
"subregion": {
"id": "ESP08",
"$valor": "Barcelona"
},
"region": {
"id": "ESPCAT",
"$valor": "Catalunya"
},
"country": {
"id": "ESP",
"$valor": "España"
}
},
"coord": {
"x": "2.1699165",
"y": "41.38792035"
}
}
]
}
},
"server": {
"$valor": "ws.cercalia.com"
},
"instance": {
"$valor": "http://cercalia-lbs-both-lines"
}
}
}
Where:
| Parameter | Description |
|---|---|
<name> | Nearest locality name, with meteo info |
<info> | Meteo forecast, with this format: |
Day +1: <day **date**> <chance of precipitation time="00-12"> <chance of precipitation time="12-24"> <snow_level time="00-12"> <snow_level time="12-24"> <sky_conditions time="00-12"> (1) <sky_conditions time="12-24"> (1) <wind><speed time="00-12"> <wind><speed time="12-24"> <temperature><max> <temperature><min> | |
Day +2: <day **date**> <chance of precipitation time="00-12"> <chance of precipitation time="12-24"> <snow_level time="00-12"> <snow_level time="12-24"> <sky_conditions time="00-12"> (1) <sky_conditions time="12-24"> (1) <wind><speed time="00-12"> <wind><speed time="12-24"> <temperature><max> <temperature><min> | |
Day +3: <day **date**> <chance of precipitation time="00-12"> <chance of precipitation time="12-24"> <snow_level time="00-12"> <snow_level time="12-24"> <sky_conditions time="00-12"> (1) <sky_conditions time="12-24"> (1) <temperature><max> <temperature><min> | |
Day +4: <day **date**> <chance of precipitation> <snow_level> <sky_conditions>(1) <temperature><max> <temperature><min> | |
Day +5: <day **date**> <chance of precipitation> <snow_level> <sky_conditions>(1) <temperature><max> <temperature><min> | |
Day +6: <day **date**> <chance of precipitation> <snow_level> <sky_conditions>(1) <temperature><max> <temperature><min> |
(1) Sky conditions values:
| Icon | ID | Description |
|---|---|---|
| 11 | Clear | |
| 12 | A little bit cloudy | |
| 13 | Cloudy intervals | |
| 14 | Cloudy | |
| 15 | Very cloudy | |
| 16 | Very cloudy | |
| 17 | Thin clouds | |
| 23 | Cloudy intervals with rain | |
| 24 | Cloudy with rain | |
| 25 | Very cloudy with rain | |
| 26 | Cloudy with rain | |
| 33 | Cloudy intervals with snow | |
| 34 | Cloudy with snow | |
| 35 | Very cloudy with snow | |
| 36 | Cloudy with snow | |
| 43 | Cloudy intervals with rain | |
| 44 | Cloudy with little rain | |
| 45 | Very cloudy with little rain | |
| 46 | Cloudy with little rain | |
| 51 | Cloudy intervals with storm | |
| 52 | Cloudy with storm | |
| 53 | Very cloudy with storm | |
| 54 | Cloudy with storm | |
| 61 | Cloudy intervals with storm and little rain | |
| 62 | Cloudy with storm and little rain | |
| 63 | Very cloudy with storm and little rain | |
| 64 | Cloudy with storm and little rain | |
| 71 | Cloudy intervals with little snow | |
| 72 | Cloudy with little snow | |
| 73 | Very cloudy with little snow | |
| 74 | Cloudy with little snow |
Example:
POIs categories
POIs categories codes:
| Category | Code |
|---|---|
| Gas stations | C001 |
| Gas station with daily updated price (only Spain) | D00GAS |
| Compressed Natural Gas Gas Stations - CNG (only Spain) | D00GNC |
| Electric vehicle charging points | D104 |
| Parking & rest area | C002 |
| Service area | C003 |
| Train station | C004 |
| Airport and Terminals | C005,C016 |
| Ferry terminal | C006 |
| Parking | C007 |
| Car sales | C008 |
| Hospital | C009 |
| Primary Assistance Center (only Spain) | D00CAP |
| Mall | C010 |
| Post Office | C011 |
| Public administration building | C012 |
| Hotel | C013 |
| Restaurant | C014 |
| Stadium | C015 |
| Airport access | C016 |
| Mountain pass | C017 |
| Embassy | C018 |
| Border crossing | C019 |
| Mountain peak | C020 |
| Panoramic view | C021 |
| Beach | C022 |
| Camping | C023 |
| ATM | C024 |
| Cinema | C025 |
| Pharmacy | C026 |
| University / School | C027 |
| Mechanical workshop | C028 |
| Tourist information center | C029 |
| Museum | C030 |
| Theater | C031 |
| Sports Center | C032 |
| Police station | C033 |
| Pool | C034 |
| Cult place | C035 |
| Casino | C036 |
| Important tourist attraction | C037 |
| Ice skating rink | C038 |
| Park and recreation area | C039 |
| Courthouse | C040 |
| Opera | C041 |
| Concert hall | C042 |
| Convention Center | C043 |
| Leisure port, sports port | C044 |
| Theme park | C045 |
| Golf course | C046 |
| Library | C047 |
| Zoo | C048 |
| Subway | C049 |
| Industrial Estate | C050 |
| Tram stop | C051 |
| Windshield workshop | C052 |
| Sale and repair of tires | C053 |
| Motorcycle workshop | C054 |
| Truck workshop | C055 |
| Car dealership | C056 |
| Motorcycle dealer | C057 |
| Yacht dealer | C058 |
| Recreational Vehicle Dealer | C059 |
| Truck dealer | C060 |
| Van dealer | C061 |
| Coach dealer | C062 |
| Snow vehicle Dealer | C063 |
| Company (transport and logistics) | C064 |
| Company (health) | C065 |
| Company (Mining & Oil & Gas) | C066 |
| Company (construction) | C067 |
| Company (companies and offices) | C068 |
| Coastal park | C069 |
| Ski resort | C070 |
| Company (bus and taxi services) | C071 |
| Botanic Park | C072 |
| Water park | C074 |
| Wildlife park | C075 |
| Bed & Breakfast | C076 |
| Hotel resort | C077 |
| Supermarket & Hypermarket | C078 |
| Military airport | C079 |
| Airfield | C080 |
| Interurban BUS stop | C081 |
| Taxi stop | C082 |
| Coach stop | C083 |
| Store (bookstore) | C084 |
| Store (CD’s, DVD & Videos) | C085 |
| Shop (clothing & accessories) | C086 |
| Store (convenience items) | C087 |
| Store (computers, electronics, photography, etc) | C088 |
| Store (real estate) | C089 |
| Shop (outlet) | C090 |
| Shop (florist) | C091 |
| Shop (food) | C092 |
| Shop (gifts, souvenirs) | C093 |
| Tent (house, garden) | C094 |
| Shop (jewelry) | C095 |
| Kiosk | C096 |
| Shop (optical) | C097 |
| Shop (sports equipment) | C098 |
| Store (toy store) | C099 |
| Shop (travel agency) | C100 |
| Tent (construction material) | C101 |
| Store (other) | C102 |
| Store (mobile phone) | C103 |
| Rent a car | C105 |
| Bank | C106 |
| Market | C107 |
| Truck parking | C108 |
| Car wash | C109 |
| Industry | C110 |
| Car rental parking | C111 |
| Public transport stop, uncategorized | C112 |
| Tramways (only Spain) | D00TRA |
| Urban BUS stops | D00BUS |
| Nurseries (only Spain) | D00GUA |
| Early childhood education schools (only Spain) | D00ESC |
| Primary schools (only Spain) | D00ESC |
| Secondary and Baccalaureate Schools (only Spain) | D00ESC |
| Professional development schools (only Spain) | D00ESC |
| Other types of schools (only Spain) | D00ESC |
| Speed cams (only Spain) | D00RAD |
| Dangerous road points (only Spain) | D00PNG |
| Traffic cameras | D00CAM |