Our Location Scores assess the quality of transportation, services, and character characteristics of any latitude/longitude location or neighbourhood in Canada or the US. With the new iteration of our Scores API, clients can now obtain up to 18 location scores for up to 4 different geography levels. Scores returned are on a scale of 0 to 5. Lat/long scores will either be .0 or .5 and neighbourhood,macro-neighbourhood and municipality scores are rounded to the nearest tenth. ie. 4.778 will become 4.8.
These levels are:
Lat/Long
Neighbourhoods
Macro neighbourhoods
Municipalities
Local Logic provides the following Location Scores, which can be accessed via the v1/scores and v3/scores endpoints documented below.
Not all Location Scores are available in all locations.
When scores are missing from the response, it means that Local Logic has insufficient information about the location to be able to provide those scores.
Location Score | ScoreName | Description |
---|---|---|
Pedestrian friendly | pedestrian_friendly | Represents how many stores and institutions are nearby and how pleasant it is to walk to them. |
Cycling friendly | cycling_friendly | Represents how suitable the area is for cycling in terms of nearby bicycle infrastructure and calm streets, as well as the number of destinations that can be reached by bicycle. |
Transit friendly | transit_friendly | Represents the frequency and level of service of public transit. |
Car friendly | car_friendly | Represents how well traffic flows, and how easy it is to park. |
Location Score | ScoreName | Description |
---|---|---|
Parks | parks | Quantity and area of parks nearby. |
Groceries | groceries | Distance to closest grocery store and quantity of grocery stores nearby. |
Shopping | shopping | Quantity and diversity of shops nearby. |
Nightlife | nightlife | Quantity and diversity of bars nearby. |
Restaurants | restaurants | Quantity and diversity of restaurants nearby. |
Cafes | cafes | Quantity and diversity of cafés. |
Daycares | daycares | Distance to closest daycare school. |
Primary Schools | primary_schools | Distance to closest elementary school. |
High Schools | high_schools | Distance to closest high school. |
Location Score | ScoreName | Description |
---|---|---|
Quiet | quiet | Level of noise nearby. |
Green | greenery | Quantity of nearby green spaces and tree canopy coverage. |
Historic | historic | Presence of heritage buildings and building age in the area. |
Vibrant | vibrant | Level of street activity nearby. |
Wellness | wellness | Presence of healthy POIs (fitness/sports, healthy restaurants/stores & parks) nearby and how pedestrian-friendly the location is. |
This PDF describes what the values of 0-10 mean for their respective scores.
Location Scores for a specific coordinate point location and neighbourhood, macro neighbourhood, and municipality which contains it, can be retrieved using a latitude/longitude request.
Scores for the latitude/longitude point location are returned as a score out of 5, with a precision to the nearest .5
. Scores for the neighbourhood, macro neighbourhood, and municipality geography scores are also returned as a score out of 5, but with a precision to the nearest .1
.
GET v3/scores
This API uses JWT token based authentication. This JWT Bearer token is what is used to populate the Authorization
header below.
Instructions on how to retrieve this token can be found at Accessing the API → V3 API Authorization.
Header | Status | Description |
---|---|---|
Authorization | required | Your bearer token retrieved from our authorization API, ex. Bearer eyJhbGci... |
Accept | required | The datatype to request, this API will return application/json . |
Parameter | Status | Description |
---|---|---|
lat | required* | A decimal number between -90 and 90 , representing the latitude. |
lng | required* | A decimal number between -180 and 180 , representing the longitude. |
geography_ids | optional* | A comma separated list of geography ids, ex. g30_dpz89rm7 or g30_dpz89rm7,g10_dpz89rm7 . If this parameter is provided, the lat and lng parameters are optional. |
geography_levels | optional | A list of geography levels to include, ex. 10,30. If no geography levels are provided, no geography scores will be returned. Available: Neighbourhood: 10 Macro-Neighbourhood or Borough: 20 Municipality: 30 |
include | optional | A list ScoreNames to return, ex. car_friendly,pedestrian_friendly . If no names are provided, all scores included in your agreement will be returned. |
language | optional | String value representing the two letter ISO 361-1 language code to return the scores in, ex. fr Available: en and fr |
location_scores_rounding | optional | The type of rounding to apply to the scores returned under data.location. Either .5 (default) to round at the nearest 0.5, or none , to disable rounding. |
require('node-fetch')('https://api.locallogic.co/v3/scores?' + new URLSearchParams({lat: 41.847206,lng: -87.668825,geography_ids: 'g30_f25dv0me',geography_levels: '10,20,30',include: 'transit_friendly,quiet',language: 'en',}), {method: 'GET',headers: {Accept: 'application/json',Authorization: 'Bearer eyJhbGciOiJ...'}}).then(response => response.json()).then(body => {console.log(body)}).catch(error => {console.log(error)})
import requestsresponse = requests.get("https://api.locallogic.co/v3/scores",headers={"Accept": "application/json","Authorization": "Bearer eyJhbGciOiJ..."},params={"lat": 43.593611,"lng": -79.536194,"geography_ids": "g30_f25dv0me","geography_levels": "10,20,30","include": "transit_friendly,quiet","language": "en",})print(response.json())# See response example below
{"data": {"type": "scores","location": {"transit_friendly": {"value": "4.5","text": "Within walking distance of a subway and frequent bus lines"},"quiet": { "value": "1.0", "text": "Many sources of noise nearby" }},"geographies": [{"geog_id": "g30_f25dv0me","name": "Westmount","geog_level_type": "municipality","scores": {"transit_friendly": {"value": "4.5","text": "Within walking distance of a subway and frequent bus lines"},"quiet": {"value": "2.7","text": "Multiple sources of noise nearby"}}},// Plus other geography score objects]},"meta": {"message": "Successfully called v3/scores API.","type": "LocalLogic.API.Success","statusCode": 200}}
Location Scores for a specific address can be retrieved using a latitude/longitude request.
GET v1/scores
Parameter | Status | Description |
---|---|---|
lat | required | A decimal number between -90 and 90 (Latitude). |
lng | required | A decimal number between -180 and 180 (Longitude). |
key | required | The API Key provided to you. |
include | optional | ScoreNames separated by commas. See a full list of ScoreNames above. If no names are provided, all scores will be returned. |
fields | optional | User defined fields separated by commas. Available: value ,text ,name ,description ,category ,icon .Default: value ,text . |
locale | optional | String value representing the language to return the scores. Available: fr (French), en (English).Default: en |
require('request')({method: 'GET',url: 'https://api.locallogic.co/v1/scores',qs: {lat: 45.5656,lng: -73.5656,key: 'YOUR_API_KEY',include: 'transit_friendly,quiet',fields: 'value,text,description,category,name',locale: 'en'}}, function (err, response, body) {// See response example})
{"data": {"type": "LocationScores","attributes": {"transit_friendly": {"value": 4.5,"text": "Good levels of bus and rapid-transit service, but low levels of commuter rail service.","name": "Transit friendly","description": "Represents the frequency and level of service of public transit","category": "Transportation"},"quiet": {"value": 3.5,"text": "A little bit noisy, due to many businesses and several bars in the area.","name": "Quiet","description": "Level of noise nearby","category": "Character"}}}}