Skip to content

Points of Interest

Stable
Available in the US and Canada

Points of interest (POIs) near a location can be accessed via Local Logic’s POIs endpoint, documented below. Up to 30 POIs in a 25 000 meter (25 km or 15.53 miles) radius can be obtained per category when multiple categories are called through the API. When a single category of POIs is requested in the parameters, up to 500 POIs will be returned within a 25 000 meters (25 km or 15.53 miles) radius from the specified lat/long.

The following categories of POIs are available.

CategoryPOI Category Name
Groceries (General)groceries
Groceries (Specialized)groceries_specialized
Shoppingshopping
Nightlifenightlife
Restaurantsrestaurants
Cafescafes
Daycares*daycares
Bus Stopsbus_stops
Rapid Transit Stationsrapid_transit_stations
Train Stationstrain_stations
Parksparks

* Canada only

V3 QueryString Request Parameters

ParameterStatusDescription
latrequiredA decimal number between -90 and 90, representing the latitude.
lngrequiredA decimal number between -180 and 180, representing the longitude.
includerequiredA comma separated list of POI category names. See the above table's POI Category Name column for a full list of available categories.
radiusoptionalUsed to specify the maximum distance away from the input lat/lng for each POI category.

default: 5 000 meters

maximum: 25 000 meters
limitoptionalThe limit of POIs returned per POI category.

default: 30

maximum: 30 if multiple POI categories specified in the include parameter, otherwise 500 if only one single POI category

V3 NodeJS Example

require('node-fetch')('https://api.locallogic.co/v3/pois?' + new URLSearchParams({
lat: 41.847206,
lng: -87.668825,
include: 'cafes,bus_stops',
radius: 3,
limit: 10
}), {
method: 'GET',
headers: {
Accept: 'application/json',
Authorization: 'Bearer eyJhbGciOiJ...'
}
})
.then(response => response.json())
.then(body => {
console.log(body)
})
.catch(error => {
console.log(error)
})

V3 Python Example

import requests
response = requests.get(
"https://api.locallogic.co/v3/pois",
headers={
"Accept": "application/json",
"Authorization": "Bearer eyJhbGciOiJ..."},
params={
"lat": 43.593611,
"lng": -79.536194,
"include": 'cafes,bus_stops',
"radius": 3,
"limit": 10
}
)
print(response.json())

200 - V3 Response Example

{
"data": {
"cafes": [
{
"name": "Tim Hortons",
"address": "11940 111 Ave Nw",
"city": "Edmonton",
"province": "AB",
"postalcode": "T5G0E5",
"country": "Canada",
"lat": 53.559654,
"lng": -113.528046,
"url": "http://timhortons.com/ca",
"proximity": {
"linear_distance": 0.491,
"walking": {
"quality": "calculated",
"distance": 0.522,
"travel_time": 6
}
}
},
{
"name": "European Sweetness Ltd",
"address": "12212 107 Ave Nw",
"city": "Edmonton",
"province": "AB",
"postalcode": "T5M4A8",
"country": "Canada",
"lat": 53.551163,
"lng": -113.53287,
"proximity": {
"linear_distance": 0.613,
"walking": {
"quality": "calculated",
"distance": 1.001,
"travel_time": 12
}
}
},
{
"name": "Second Cup",
"address": "11640 104 Ave Nw",
"city": "Edmonton",
"province": "AB",
"postalcode": "T5K2T7",
"country": "Canada",
"lat": 53.547203,
"lng": -113.52228,
"url": "http://secondcup.com",
"proximity": {
"linear_distance": 0.95,
"walking": {
"quality": "calculated",
"distance": 1.029,
"travel_time": 12
}
}
},
// Plus other cafes
],
"bus_stops": [
{
"name": "119 Street & 111 Avenue",
"country": "Canada",
"lat": 53.558764,
"lng": -113.526336,
"routes": [
{
"short_name": "125",
"long_name": "Belvedere - Jasper Place",
"route_color": "#FFFFFF",
"text_color": "#000000"
}
],
"proximity": {
"linear_distance": 0.386
}
},
// Plus other bus_stops
]
},
"meta": {
"message": "Successfully called v3/pois API.",
"type": "LocalLogic.API.Success",
"statusCode": 200,
"counts": {
"returned": {
"cafes": 10,
"bus_stops": 10
}
}
}
}