Points of Interest (POIs)

Show POIs on the map, get the POIs along a route, weather info, gas stations, etc.

API Access

The Points of Interest (POI) API enables location-based POI search, routing-based proximity queries, and retrieval of weather forecasts and specialized categories (gas stations, hospitals, etc.). It is available via HTTP-JSON and XML services.

Base Service URLs:

  • Supported methods: GET or POST
  • Response formats: JSON / XML

Get the Nearest POIs

Request Parameters

Example:

https://lb.cercalia.com/services/v2/json?cmd=prox&mo=40.3691,-3.589&mocs=gdd&rqpoicats=C001&num=2&rad=10000&key=YOUR_API_KEY
ParameterDescription
moSearch center coordinates (format: lat,lon or ID).
mocsCoordinate system (gdd for geographical WGS84 lat/lon).
rqpoicatsList of POI categories (comma-separated), ordered by proximity.
numMaximum number of POIs to return (max: 1000).
radMaximum search radius in meters.

Response Structure

{
    "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": {
                            "value": "Repsol SuperCOR Stop&Go La Superestación"
                        },
                        "info": {
                            "value": "Repsol SuperCOR Stop&Go La Superestación. 28051 Madrid. Tel: +(34)-(914)-860484"
                        },
                        "ge": {
                            "street": {
                                "@id": "UNKNOWN"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Madrid"
                            },
                            "municipality": {
                                "@id": "ESP280796",
                                "value": "Madrid"
                            },
                            "subregion": {
                                "@id": "ESP28",
                                "value": "Madrid"
                            },
                            "region": {
                                "@id": "ESPMAD",
                                "value": "Comunidad de Madrid"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "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": {
                            "value": "ÁREA 117"
                        },
                        "info": {
                            "value": "ÁREA 117. Avenida Del Mediterráneo, Km11.9, 28051 Madrid. Tel: +(34)-(692)-982944. Web: www.area117.es"
                        },
                        "ge": {
                            "housenumber": {
                                "value": "Km11.9"
                            },
                            "street": {
                                "@id": "UNKNOWN",
                                "value": "Avenida Del Mediterráneo"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Madrid"
                            },
                            "municipality": {
                                "@id": "ESP280796",
                                "value": "Madrid"
                            },
                            "subregion": {
                                "@id": "ESP28",
                                "value": "Madrid"
                            },
                            "region": {
                                "@id": "ESPMAD",
                                "value": "Comunidad de Madrid"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "España"
                            }
                        },
                        "coord": {
                            "@x": "-3.58657767",
                            "@y": "40.36795155"
                        }
                    }
                ]
            }
        },
        "server": {
            "value": "lb.cercalia.com"
        },
        "instance": {
            "value": "http://master-cercalia-lbs-both-lines"
        }
    }
}
FieldDescription
distStraight-line distance from center to POI in meters.
posProximity ranking (1 = closest).
namePOI name.
infoAdditional POI information (address, phone, etc.).

Get the Nearest POIs Using Routing

Request Parameters

Example:

https://lb.cercalia.com/services/v2/json?cmd=prox&mo=40.3691,-3.589&rqpoicats=C001&num=2&&weight=time&mocs=gdd&inverse=0&key=YOUR_API_KEY
ParameterDescription
moSearch center coordinates (format: lat,lon).
mocsCoordinate system (gdd for WGS84).
rqpoicatsList of POI categories (comma-separated), ordered by routing distance/time.
numMaximum number of POIs to return (optional).
radMaximum radius in meters (optional).
weightRoute optimization type: time (fastest), distance (shortest), money (fastest avoiding tolls), realtime (considering live traffic).
iweightUse realtime to get route times based on current traffic state.
inverseDirection: 0 = center to POIs, 1 = POIs to center.

Routing Based on Departure Time:

ParameterDescription
weightsptime (fastest based on departure time) or spmoney (fastest avoiding tolls based on departure time).
departuretimeDeparture date/time in ISO 8601 format (e.g., 2019-10-16T07:30:12Z). Required when using sptime or spmoney.

Response Structure

{
    "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"
        }
    }
}
FieldDescription
distStraight-line distance from center to POI in meters.
routedistActual route distance from center to POI in meters.
routetimeRoute travel time from center to POI in milliseconds.
routeweightRoute optimization value (based on selected weight).

Get POIs Along a Route

Request Parameters

Example:

https://lb.cercalia.com/services/v2/json?cmd=geom&routeweight=time&tolerance=5&routeid=2767920,2778988|0.6167333,0.6414299&getpoicats=C001&buffer=50&key=YOUR_API_KEY
ParameterDescription
routeidRoute ID from a previous cmd=route request (available for several hours).
routeweightRoute type used in the route request (e.g., time, distance).
getpoicatsPOI categories to search along the route.
bufferBuffer distance for POI search in meters (e.g., 50).
toleranceRoute polyline simplification distance in meters (default: 100).

Response Structure

{
    "cercalia": {
        "@cmd": "geom",
        "@version": "1",
        "getpoicats": {
            "poicats": {
                "poicat": [
                    {
                        "value": "C001"
                    }
                ]
            },
            "poilist": {
                "@num": "1",
                "poi": [
                    {
                        "@category_id": "C001",
                        "@geometry": "P",
                        "@id": "C001#724009007947185",
                        "@subcategory_id": "-1",
                        "name": {
                            "value": "BP Rio Grande"
                        },
                        "info": {
                            "value": "BP Rio Grande. 29570 Cártama. Tel: +(34)-(952)-118249. Web: www.bp.com"
                        },
                        "ge": {
                            "street": {
                                "@id": "UNKNOWN"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Cártama"
                            },
                            "municipality": {
                                "@id": "ESP290385",
                                "value": "Cártama"
                            },
                            "subregion": {
                                "@id": "ESP29",
                                "value": "Málaga"
                            },
                            "region": {
                                "@id": "ESPAND",
                                "value": "Andalucía"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "España"
                            }
                        },
                        "coord": {
                            "@x": "-4.70159355",
                            "@y": "36.72036604"
                        }
                    }
                ]
            }
        },
        "server": {
            "value": "lb.cercalia.com"
        },
        "instance": {
            "value": "http://master-cercalia-lbs-both-lines"
        }
    }
}

Get POIs Inside a Map Extension

Request Parameters

Example:

https://lb.cercalia.com/services/v2/json?cmd=map&map=0&extent=42.144102962,-0.414886914|42.139342832,-0.407628526&cs=gdd&getpoicats=D00GAS&key=YOUR_API_KEY
ParameterDescription
map0 = POI list only (faster), 1 = include static map image.
csCoordinate system (gdd for WGS84).
extentMap bounding box: `Y,X
getpoicatsPOI categories to search within the extent.

Response Structure

{
    "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": [
                    {
                        "value": "D00GAS"
                    }
                ],
                "poilist": {
                    "poi": [
                        {
                            "@category_id": "D00GAS",
                            "@geometry": "P",
                            "@id": "D00GAS#D00IDEESS1314I",
                            "@subcategory_id": "REP",
                            "name": {
                                "value": "REPSOL"
                            },
                            "info": {
                                "value": "I|AVENIDA PAZ LA, 33|HUESCA|Huesca|HUESCA|22004|L-D: 24H|P|1.469|1.399|||||0.0||0.0||2025-06-03T07:15:13"
                            },
                            "ge": {
                                "city": {
                                    "@id": "UNKNOWN",
                                    "value": "Huesca"
                                },
                                "municipality": {
                                    "@id": "ESP221259",
                                    "value": "Aragón"
                                },
                                "subregion": {
                                    "@id": "ESP22",
                                    "value": "Huesca"
                                },
                                "region": {
                                    "@id": "ESPARA",
                                    "value": "Aragón"
                                },
                                "country": {
                                    "@id": "ESP",
                                    "value": "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": {
                                "value": "REPSOL"
                            },
                            "info": {
                                "value": "D|CALLE COSO ALTO, 65|HUESCA|Huesca|HUESCA|22003|L-V: 07:00-15:00|P|1.469|1.379|||||0.0||0.0||2025-06-03T07:15:13"
                            },
                            "ge": {
                                "city": {
                                    "@id": "UNKNOWN",
                                    "value": "Huesca"
                                },
                                "municipality": {
                                    "@id": "ESP221259",
                                    "value": "Aragón"
                                },
                                "subregion": {
                                    "@id": "ESP22",
                                    "value": "Huesca"
                                },
                                "region": {
                                    "@id": "ESPARA",
                                    "value": "Aragón"
                                },
                                "country": {
                                    "@id": "ESP",
                                    "value": "España"
                                }
                            },
                            "coord": {
                                "@x": "-0.41050314",
                                "@y": "42.14119478"
                            },
                            "pixels": {
                                "@x": "187",
                                "@y": "136"
                            }
                        }
                    ]
                }
            }
        },
        "server": {
            "value": "lb.cercalia.com"
        },
        "instance": {
            "value": "http://master-cercalia-lbs-both-lines"
        }
    }
}

Get POIs Inside a Map Extension with Zoom Filtering

Request Parameters

Example:

https://lb.cercalia.com/services/v2/json?cmd=map&map=0&extent=42.144102962,-0.414886914|42.139342832,-0.407628526&cs=gdd&mocs=gdd&gpoicats=D00GAS&key=YOUR_API_KEY
ParameterDescription
map0 = POI list only, 1 = include static map image.
csCoordinate system (gdd for WGS84).
extentMap bounding box: `Y,X
gpoicatsPOI categories to search (with zoom filtering applied).
gridsizeGrid size for POI clustering/filtering (higher = more filtering). Optional.

Response Structure

{
    "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": [
                    {
                        "value": "D00GAS"
                    }
                ],
                "poilist": {
                    "poi": [
                        {
                            "@category_id": "D00GAS",
                            "@id": "D00GAS#D00IDEESS1314I",
                            "@subcategory_id": "REP",
                            "name": {
                                "value": "REPSOL"
                            },
                            "info": {
                                "value": "I|AVENIDA PAZ LA, 33|HUESCA|Huesca|HUESCA|22004|L-D: 24H|P|1.469|1.399|||||0.0||0.0||2025-06-03T07:15:13"
                            },
                            "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": {
                                "value": "REPSOL"
                            },
                            "info": {
                                "value": "D|CALLE COSO ALTO, 65|HUESCA|Huesca|HUESCA|22003|L-V: 07:00-15:00|P|1.469|1.379|||||0.0||0.0||2025-06-03T07:15:13"
                            },
                            "ge": {
                                "municipality": {
                                    "@id": "ESP221259"
                                }
                            },
                            "coord": {
                                "@x": "-0.41050314",
                                "@y": "42.14119478"
                            },
                            "pixels": {
                                "@x": "187",
                                "@y": "136"
                            }
                        }
                    ]
                }
            }
        },
        "server": {
            "value": "lb.cercalia.com"
        },
        "instance": {
            "value": "http://master-cercalia-lbs-both-lines"
        }
    }
}

Get POIs Inside a Polygon

Request Parameters

Example:

https://lb.cercalia.com/services/v2/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
ParameterDescription
csCoordinate system (4326 for WGS84 lat/lon).
wktPolygon geometry in WKT format (URL-encoded).
rqpoicatsPOI categories to search within the polygon.

Response Structure

{
    "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": "5",
                "poi": [
                    {
                        "@category_id": "C001",
                        "@geometry": "P",
                        "@id": "C001#724009007934310",
                        "@subcategory_id": "-1",
                        "name": {
                            "value": "Repsol Virgen Montserrat"
                        },
                        "info": {
                            "value": "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": {
                                "value": "87"
                            },
                            "street": {
                                "@id": "UNKNOWN",
                                "value": "Avinguda de la Mare de Déu de Montserrat"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Barcelona"
                            },
                            "municipality": {
                                "@id": "ESP080193",
                                "value": "Barcelona"
                            },
                            "subregion": {
                                "@id": "ESP08",
                                "value": "Barcelona"
                            },
                            "region": {
                                "@id": "ESPCAT",
                                "value": "Catalunya"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "España"
                            }
                        },
                        "coord": {
                            "@x": "2.16697003",
                            "@y": "41.41551638"
                        }
                    },
                    {
                        "@category_id": "C001",
                        "@geometry": "P",
                        "@id": "C001#724009033832084",
                        "@subcategory_id": "-1",
                        "name": {
                            "value": "Cepsa"
                        },
                        "info": {
                            "value": "Cepsa. Avenida De Gaudí, 1, 08025 Barcelona. Web: store.totalenergies.fr/en_EN/ES_EXT_2196"
                        },
                        "ge": {
                            "housenumber": {
                                "value": "1"
                            },
                            "street": {
                                "@id": "UNKNOWN",
                                "value": "Avenida De Gaudí"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Barcelona"
                            },
                            "municipality": {
                                "@id": "ESP080193",
                                "value": "Barcelona"
                            },
                            "subregion": {
                                "@id": "ESP08",
                                "value": "Barcelona"
                            },
                            "region": {
                                "@id": "ESPCAT",
                                "value": "Catalunya"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "España"
                            }
                        },
                        "coord": {
                            "@x": "2.17421943",
                            "@y": "41.40489872"
                        }
                    },
                    {
                        "@category_id": "C001",
                        "@geometry": "P",
                        "@id": "C001#724009005184853",
                        "@subcategory_id": "-1",
                        "name": {
                            "value": "Repsol Legalitat"
                        },
                        "info": {
                            "value": "Repsol Legalitat. Carrer de la Legalitat, 59, 08024 Barcelona. Tel: +(34)-(932)-195641. Web: www.repsol.com"
                        },
                        "ge": {
                            "housenumber": {
                                "value": "59"
                            },
                            "street": {
                                "@id": "UNKNOWN",
                                "value": "Carrer de la Legalitat"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Barcelona"
                            },
                            "municipality": {
                                "@id": "ESP080193",
                                "value": "Barcelona"
                            },
                            "subregion": {
                                "@id": "ESP08",
                                "value": "Barcelona"
                            },
                            "region": {
                                "@id": "ESPCAT",
                                "value": "Catalunya"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "España"
                            }
                        },
                        "coord": {
                            "@x": "2.16166098",
                            "@y": "41.40873345"
                        }
                    },
                    {
                        "@category_id": "C001",
                        "@geometry": "P",
                        "@id": "C001#724009007931669",
                        "@subcategory_id": "-1",
                        "name": {
                            "value": "Repsol San Juan-Diagonal"
                        },
                        "info": {
                            "value": "Repsol San Juan-Diagonal. Plaça del Mossèn Jacint Verdaguer, 08037 Barcelona. Web: www.repsol.com"
                        },
                        "ge": {
                            "street": {
                                "@id": "UNKNOWN",
                                "value": "Plaça del Mossèn Jacint Verdaguer"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Barcelona"
                            },
                            "municipality": {
                                "@id": "ESP080193",
                                "value": "Barcelona"
                            },
                            "subregion": {
                                "@id": "ESP08",
                                "value": "Barcelona"
                            },
                            "region": {
                                "@id": "ESPCAT",
                                "value": "Catalunya"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "España"
                            }
                        },
                        "coord": {
                            "@x": "2.16966497",
                            "@y": "41.3993322"
                        }
                    },
                    {
                        "@category_id": "C001",
                        "@geometry": "P",
                        "@id": "C001#724006003544906",
                        "@subcategory_id": "-1",
                        "name": {
                            "value": "Ballenoil"
                        },
                        "info": {
                            "value": "Ballenoil. Calle De La Industria, 38, 08025 Barcelona. Web: www.ballenoil.es/gasolineras-ballenoil/barbera-del-valles/"
                        },
                        "ge": {
                            "housenumber": {
                                "value": "38"
                            },
                            "street": {
                                "@id": "UNKNOWN",
                                "value": "Calle De La Industria"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Barcelona"
                            },
                            "municipality": {
                                "@id": "ESP080193",
                                "value": "Barcelona"
                            },
                            "subregion": {
                                "@id": "ESP08",
                                "value": "Barcelona"
                            },
                            "region": {
                                "@id": "ESPCAT",
                                "value": "Catalunya"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "España"
                            }
                        },
                        "coord": {
                            "@x": "2.16715867",
                            "@y": "41.40394507"
                        }
                    }
                ]
            }
        },
        "server": {
            "value": "lb.cercalia.com"
        },
        "instance": {
            "value": "http://master-cercalia-lbs-both-lines"
        }
    }
}

Weather Forecast Location

Retrieve weather forecasts for any global coordinate. Forecast density varies by country.

Request Parameters

Example:

https://lb.cercalia.com/services/v2/json?cmd=prox&rqpoicats=D00M05&mocs=gdd&mo=41.39818,2.1490287&key=YOUR_API_KEY
ParameterDescription
mocsCoordinate system (gdd for WGS84).
moCoordinate to query (format: lat,lon).
rqpoicatsUse D00M05 for weather forecast category.

Response Structure

{
    "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": {
                            "value": "Barcelona"
                        },
                        "info": {
                            "value": "2023-10-05T07:22:08|2023-10-05|0|0|||12|12|10|10|28|22|2023-10-06|0|0|||11|11|15|15|28|21|2023-10-07|0|0|||12|12|27|21|2023-10-08|0||12|27|21|2023-10-09|0||12|26|20|2023-10-10|0||12|27|19"
                        },
                        "ge": {
                            "street": {
                                "@id": "UNKNOWN"
                            },
                            "city": {
                                "@id": "UNKNOWN",
                                "value": "Barcelona"
                            },
                            "municipality": {
                                "@id": "ESP080193",
                                "value": "Barcelona"
                            },
                            "subregion": {
                                "@id": "ESP08",
                                "value": "Barcelona"
                            },
                            "region": {
                                "@id": "ESPCAT",
                                "value": "Catalunya"
                            },
                            "country": {
                                "@id": "ESP",
                                "value": "España"
                            }
                        },
                        "coord": {
                            "@x": "2.1699165",
                            "@y": "41.38792035"
                        }
                    }
                ]
            }
        },
        "server": {
            "value": "lb.cercalia.com"
        },
        "instance": {
            "value": "http://master-cercalia-lbs-both-lines"
        }
    }
}

Weather Info Format

The <info> field contains a pipe-delimited weather forecast with the following structure:

Day +1 and +2:

  • Date
  • Precipitation chance (00-12h, 12-24h)
  • Snow level (00-12h, 12-24h)
  • Sky conditions code (00-12h, 12-24h)
  • Wind speed (00-12h, 12-24h)
  • Max/min temperature

Day +3 to +6:

  • Date
  • Precipitation chance
  • Snow level
  • Sky conditions code
  • Max/min temperature

Sky Condition Codes

IDDescription
11Clear
12A little bit cloudy
13Cloudy intervals
14Cloudy
15Very cloudy
16Very cloudy
17Thin clouds
23Cloudy intervals with rain
24Cloudy with rain
25Very cloudy with rain
26Cloudy with rain
33Cloudy intervals with snow
34Cloudy with snow
35Very cloudy with snow
36Cloudy with snow
43Cloudy intervals with rain
44Cloudy with little rain
45Very cloudy with little rain
46Cloudy with little rain
51Cloudy intervals with storm
52Cloudy with storm
53Very cloudy with storm
54Cloudy with storm
61Cloudy intervals with storm and little rain
62Cloudy with storm and little rain
63Very cloudy with storm and little rain
64Cloudy with storm and little rain
71Cloudy intervals with little snow
72Cloudy with little snow
73Very cloudy with little snow
74Cloudy with little snow

POI Categories

The following category codes can be used with the rqpoicats or getpoicats parameters:

CategoryCode
Gas stationsC001
Gas station with daily updated price (only Spain)D00GAS
Compressed Natural Gas Gas Stations - CNG (only Spain)D00GNC
Electric vehicle charging pointsC104
Parking & rest areaC002
Service areaC003
Train stationC004
Airport and TerminalsC005,C016
Ferry terminalC006
ParkingC007
Car salesC008
HospitalC009
Primary Assistance Center (only Spain)D00CAP
MallC010
Post OfficeC011
Public administration buildingC012
HotelC013
RestaurantC014
StadiumC015
Airport accessC016
Mountain passC017
EmbassyC018
Border crossingC019
Mountain peakC020
Panoramic viewC021
BeachC022
CampingC023
ATMC024
CinemaC025
PharmacyC026
University / SchoolC027
Mechanical workshopC028
Tourist information centerC029
MuseumC030
TheaterC031
Sports CenterC032
Police stationC033
PoolC034
Cult placeC035
CasinoC036
Important tourist attractionC037
Ice skating rinkC038
Park and recreation areaC039
CourthouseC040
OperaC041
Concert hallC042
Convention CenterC043
Leisure port, sports portC044
Theme parkC045
Golf courseC046
LibraryC047
ZooC048
SubwayC049
Industrial EstateC050
Tram stopC051
Windshield workshopC052
Sale and repair of tiresC053
Motorcycle workshopC054
Truck workshopC055
Car dealershipC056
Motorcycle dealerC057
Yacht dealerC058
Recreational Vehicle DealerC059
Truck dealerC060
Van dealerC061
Coach dealerC062
Snow vehicle DealerC063
Company (transport and logistics)C064
Company (health)C065
Company (Mining & Oil & Gas)C066
Company (construction)C067
Company (companies and offices)C068
Coastal parkC069
Ski resortC070
Company (bus and taxi services)C071
Botanic ParkC072
Water parkC074
Wildlife parkC075
Bed & BreakfastC076
Hotel resortC077
Supermarket & HypermarketC078
Military airportC079
AirfieldC080
Interurban BUS stopC081
Taxi stopC082
Coach stopC083
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
KioskC096
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 carC105
BankC106
MarketC107
Truck parkingC108
Car washC109
IndustryC110
Car rental parkingC111
Public transport stop, uncategorizedC112
Tramways (only Spain)D00TRA
Urban BUS stopsD00BUS
NurseriesD00GUA
Early childhood education schoolsD00ESC
Primary schoolsD00ESC
Secondary and Baccalaureate SchoolsD00ESC
Professional development schoolsD00ESC
Other types of schoolsD00ESC
Speed cams (only Spain)D00RAD
Dangerous road points (only Spain)D00PNG
Traffic camerasD00CAM