Aller au contenu principal
Dernière mise à jour le

Location Scores

StableÉ.-U. 🇺🇸 et Canada 🇨🇦Disponible via MCP 🔌

Pour les cas d'utilisation, la couverture et la tarification, consultez la présentation du produit Location Scores.

Description​

Nos scores de localisation évaluent la qualité des caractéristiques liées au transport, aux services et au caractère des lieux. Ils sont répartis en 18 scores sur une échelle de 0 à 5, qui sont doublés pour afficher des scores sur 10 dans nos produits SDK.

Il est possible d'interroger nos scores de localisation pour des lieux, des inscriptions et des adresses précises, à l'aide de la latitude et de la longitude, ou pour des géographies Local Logic précises à l'aide de geog_ids uniques. Les scores de localisation sont disponibles pour les quartiers (niveaux 10, 20), les villes (niveau 30), les codes postaux (niveau 32), les subdivisions de comté américaines (niveau 35), les comtés américains et canadiens et équivalents de comté (niveau 37), les régions (niveau 38) et les régions métropolitaines de recensement (niveau 40). Les scores de localisation au niveau des géographies et des quartiers représentent les meilleures estimations de la valeur médiane des ménages pour chaque score.

Types de scores​

Local Logic fournit les scores de localisation suivants, qui sont accessibles par l'entremise du point de terminaison /v3/scores documenté ci-dessous.

info

Tous les scores de localisation ne sont pas disponibles pour tous les lieux.

Lorsque des scores sont absents de la réponse, cela signifie que Local Logic ne dispose pas de renseignements suffisants sur le lieu pour pouvoir fournir ces scores.

Transport​

Score de localisationScoreNameDescription
Adapté aux piétonspedestrian_friendlyMesure la quantité de commerces et de services à distance de marche, à quel point ils sont adaptés aux piétons et à quel point il est agréable de s'y rendre à pied.
Adapté aux cyclistescycling_friendlyReprésente la qualité de l'aménagement du réseau cyclable autant pour les déplacements que pour le cyclisme récréatif, considérant les pistes et bandes cyclables à proximité, le pourcentage d'habitants qui se déplacent à vélo, le dénivelé du terrain ainsi que la présence de vélos en libre-service.
Transport publictransit_friendlyReprésente la fréquence et le niveau de service du transport en commun.
Adapté aux voiturescar_friendlyReprésente la fluidité de la circulation et la facilité de stationnement.

Services​

Score de localisationScoreNameDescription
ÉpiceriesgroceriesDistance jusqu'à l'épicerie la plus proche et nombre d'épiceries à proximité.
MagasinsshoppingQuantité et diversité des commerces à proximité.
CaféscafesQuantité et diversité des cafés à proximité.
RestaurantsrestaurantsQuantité et diversité des restaurants à proximité.
Vie nocturnenightlifeQuantité et diversité des bars à proximité.

Éducation​

Score de localisationScoreNameDescription
Écoles secondaireshigh_schoolsDistance jusqu'à l'école secondaire la plus proche.
Écoles primairesprimary_schoolsDistance jusqu'à l'école primaire la plus proche.
GarderiesdaycaresDistance jusqu'à la garderie la plus proche.

Caractère​

Score de localisationScoreNameDescription
SilencieuxquietNiveau de bruit à proximité.
HistoriquehistoricPrésence de bâtiments patrimoniaux et âge des bâtiments dans le secteur.
Remarque : la couverture Historique est actuellement offerte dans deux villes américaines et une ville canadienne.
DynamismevibrantNiveau d'activité de rue à proximité.

Nature​

Score de localisationScoreNameDescription
ParcsparksQuantité et superficie des parcs à proximité.
VerduregreeneryQuantité d'espaces verts et couverture du couvert arboré à proximité.
Remarque : la couverture Verdure est actuellement offerte dans 8 villes américaines et deux villes canadiennes.

Bien-être​

Score de localisationScoreNameDescription
Bien-êtrewellnessReprésente la quantité de commodités à distance de marche favorisant l'activité physique et une alimentation saine.

Que signifient les valeurs des cotes?​

Les tableaux ci-dessous (regroupés par catégorie) expliquent comment Local Logic traduit les valeurs décimales des cotes en une description textuelle de ce que chaque valeur signifie. Ces descriptions sont aussi renvoyées par le point de terminaison de l'API; elles sont reprises ici à titre de référence.

Il y a une colonne pour la valeur API (0 à 5) de chaque cote, ainsi qu'une colonne pour la valeur d'affichage (0 à 10), soit la façon dont les cotes sont présentées dans nos SDK, nos rapports et lorsqu'elles sont renvoyées par le serveur MCP.

Transport​

Pratique pour les piétons​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Nombre exceptionnel de rues agréables et de commerces adaptés aux piétons à quelques minutes de marche. Combler ses besoins quotidiens à pied est presque toujours commode
4,0 – <4,58,0 – <9,0Grand nombre de rues agréables et de commerces adaptés aux piétons à quelques minutes de marche. Combler ses besoins quotidiens à pied est généralement commode
3,0 – <4,06,0 – <8,0Beaucoup de rues agréables et de commerces adaptés aux piétons à courte distance de marche. Combler ses besoins quotidiens à pied est souvent commode
2,0 – <3,04,0 – <6,0Quelques commerces adaptés aux piétons à distance de marche. Combler ses besoins quotidiens à pied est parfois commode
1,0 – <2,02,0 – <4,0Peu de commerces adaptés aux piétons à distance de marche. Combler ses besoins quotidiens à pied est rarement commode ou agréable
0,0 – <1,00,0 – <2,0Très peu ou aucun commerce adapté aux piétons à distance de marche. Combler ses besoins quotidiens à pied n'est presque jamais commode ni agréable

Pratique pour les cyclistes​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Exceptionnellement approprié pour les déplacements à vélo et/ou pour le cyclisme récréatif
4,0 – <4,58,0 – <9,0Très approprié pour les déplacements à vélo et/ou pour le cyclisme récréatif
3,0 – <4,06,0 – <8,0Approprié pour les déplacements à vélo et/ou pour le cyclisme récréatif
2,0 – <3,04,0 – <6,0Plutôt adapté pour les déplacements à vélo et/ou pour le cyclisme récréatif
1,0 – <2,02,0 – <4,0Peu adapté pour les déplacements à vélo et/ou pour le cyclisme récréatif
0,0 – <1,00,0 – <2,0Pas du tout adapté pour les déplacements à vélo et/ou pour le cyclisme récréatif

Transport en commun​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0À proximité d'une grande variété de lignes de métro et/ou d'autres transports en commun rapides et fréquents
4,0 – <4,58,0 – <9,0À proximité d'au moins une ligne de métro et/ou d'autres transports en commun rapides et fréquents
3,0 – <4,06,0 – <8,0À distance de marche d'au moins une ligne de transports en commun fréquente
2,0 – <3,04,0 – <6,0Transport en commun disponible pour la plupart des déplacements
1,0 – <2,02,0 – <4,0Transport en commun disponible pour certains déplacements
0,0 – <1,00,0 – <2,0Transport en commun à proximité peu fréquent ou absent

Convivial pour les automobilistes​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Accès exceptionnel à des voies rapides et/ou des artères majeures, avec un risque quasi nul de problèmes de stationnement
4,0 – <4,58,0 – <9,0Accès excellent à des voies rapides et/ou des artères majeures, avec un très faible risque de problèmes de stationnement
3,0 – <4,06,0 – <8,0Accès à des voies rapides et/ou des artères majeures, avec un faible risque de problèmes de stationnement
2,0 – <3,04,0 – <6,0Artères à proximité, mais problèmes de circulation et de stationnement possibles
1,0 – <2,02,0 – <4,0Artères à proximité, mais environnement dense avec potentiel élevé de congestion et de problèmes de stationnement
0,0 – <1,00,0 – <2,0Risque de congestion et de problèmes de stationnement élevé

Services​

Épiceries​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Variété exceptionnelle d'épiceries à quelques pas
4,0 – <4,58,0 – <9,0Grande variété d'épiceries à quelques pas
3,0 – <4,06,0 – <8,0Grande variété d'épiceries à quelques minutes en voiture, dont certaines à distance de marche
2,0 – <3,04,0 – <6,0Plusieurs épiceries à quelques minutes en voiture
1,0 – <2,02,0 – <4,0Quelques épiceries à quelques minutes en voiture
0,0 – <1,00,0 – <2,0Peu ou pas d'épiceries à quelques minutes en voiture

Restaurants​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Variété exceptionnelle de restaurants à quelques pas
4,0 – <4,58,0 – <9,0Grande variété de restaurants à quelques pas
3,0 – <4,06,0 – <8,0Grande variété de restaurants à quelques minutes en voiture, dont certains à distance de marche
2,0 – <3,04,0 – <6,0Plusieurs restaurants à quelques minutes en voiture
1,0 – <2,02,0 – <4,0Quelques restaurants à quelques minutes en voiture
0,0 – <1,00,0 – <2,0Peu ou pas de restaurants à quelques minutes en voiture

Cafés​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Variété exceptionnelle de cafés à quelques pas
4,0 – <4,58,0 – <9,0Grande variété de cafés à quelques pas
3,0 – <4,06,0 – <8,0Grande variété de cafés à quelques minutes en voiture, dont certains à distance de marche
2,0 – <3,04,0 – <6,0Plusieurs cafés à quelques minutes en voiture
1,0 – <2,02,0 – <4,0Quelques cafés à quelques minutes en voiture
0,0 – <1,00,0 – <2,0Peu ou pas de cafés à quelques minutes en voiture

Magasinage​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Variété exceptionnelle de magasins à quelques pas
4,0 – <4,58,0 – <9,0Grande variété de magasins à quelques pas
3,0 – <4,06,0 – <8,0Grande variété de magasins à quelques minutes en voiture, dont certains à distance de marche
2,0 – <3,04,0 – <6,0Plusieurs magasins à quelques minutes en voiture
1,0 – <2,02,0 – <4,0Quelques magasins à quelques minutes en voiture
0,0 – <1,00,0 – <2,0Peu ou pas de magasins à quelques minutes en voiture

Vie nocturne​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Variété exceptionnelle de bars à quelques pas
4,0 – <4,58,0 – <9,0Grande variété de bars à quelques pas
3,0 – <4,06,0 – <8,0Grande variété de bars à quelques minutes en voiture, dont certains à distance de marche
2,0 – <3,04,0 – <6,0Plusieurs bars à quelques minutes en voiture
1,0 – <2,02,0 – <4,0Quelques bars à quelques minutes en voiture
0,0 – <1,00,0 – <2,0Peu ou pas de bars à quelques minutes en voiture

Éducation​

Écoles primaires​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Au moins une école primaire à moins de 5 minutes à pied
4,0 – <4,58,0 – <9,0Au moins une école primaire à moins de 10 minutes à pied
3,0 – <4,06,0 – <8,0Au moins une école primaire à moins de 15 minutes à pied
2,0 – <3,04,0 – <6,0Au moins une école primaire à moins de 20 minutes à pied
1,0 – <2,02,0 – <4,0Au moins une école primaire à moins de 30 minutes à pied
0,0 – <1,00,0 – <2,0École primaire à plus de 30 minutes à pied

Écoles secondaires​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Au moins une école secondaire à moins de 5 minutes à pied
4,0 – <4,58,0 – <9,0Au moins une école secondaire à moins de 10 minutes à pied
3,0 – <4,06,0 – <8,0Au moins une école secondaire à moins de 15 minutes à pied
2,0 – <3,04,0 – <6,0Au moins une école secondaire à moins de 20 minutes à pied
1,0 – <2,02,0 – <4,0Au moins une école secondaire à moins de 30 minutes à pied
0,0 – <1,00,0 – <2,0École secondaire à plus de 30 minutes à pied

Garderies​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Au moins une garderie à quelques pas à pied
4,0 – <4,58,0 – <9,0Au moins une garderie à quelques minutes à pied
3,0 – <4,06,0 – <8,0Au moins une garderie à quelques minutes à peine en voiture
2,0 – <3,04,0 – <6,0Au moins une garderie à quelques minutes en voiture
1,0 – <2,02,0 – <4,0Au moins une garderie à distance raisonnable en voiture
0,0 – <1,00,0 – <2,0Garderie assez loin en voiture

Nature​

Parcs​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Superficie exceptionnellement grande de parcs à quelques minutes de marche
4,0 – <4,58,0 – <9,0Très grande superficie de parcs à quelques minutes de marche
3,0 – <4,06,0 – <8,0Grande superficie de parcs à proximité
2,0 – <3,04,0 – <6,0Superficie moyenne de parcs à proximité
1,0 – <2,02,0 – <4,0Accès limité à des parcs à proximité
0,0 – <1,00,0 – <2,0Faible accès à des parcs à proximité

Verdure​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Nombre exceptionnel d'arbres dans les environs et accès à des grands parcs
4,0 – <4,58,0 – <9,0Grand nombre d'arbres dans les environs et accès à de grands parcs
3,0 – <4,06,0 – <8,0Grand nombre d'arbres et bonne superficie de parcs à proximité
2,0 – <3,04,0 – <6,0Quelques arbres et parcs à proximité
1,0 – <2,02,0 – <4,0Peu d'arbres ou de parcs à proximité
0,0 – <1,00,0 – <2,0Très peu d'arbres ou de parcs à proximité

Caractère​

Silencieux​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Pas ou très peu de sources de bruit à proximité
4,0 – <4,58,0 – <9,0Très peu de sources de bruit à proximité
3,0 – <4,06,0 – <8,0Peu de sources de bruit à proximité
2,0 – <3,04,0 – <6,0Certaines sources de bruit à proximité
1,0 – <2,02,0 – <4,0Plusieurs sources de bruit à proximité
0,0 – <1,00,0 – <2,0Grande quantité de sources de bruit à proximité

Dynamique​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Ambiance exceptionnellement dynamique à toute heure de la journée
4,0 – <4,58,0 – <9,0Ambiance très dynamique à toute heure de la journée
3,0 – <4,06,0 – <8,0Ambiance dynamique toute la journée et en soirée
2,0 – <3,04,0 – <6,0Ambiance dynamique à certains moments de la journée
1,0 – <2,02,0 – <4,0Ambiance calme en soirée et pendant la journée
0,0 – <1,00,0 – <2,0Ambiance très calme toute la journée

Historique​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Nombre exceptionnel d’édifices anciens et bâtiments patrimoniaux à proximité
4,0 – <4,58,0 – <9,0Grand nombre d’édifices anciens et bâtiments patrimoniaux à proximité
3,0 – <4,06,0 – <8,0Plusieurs édifices anciens et bâtiments patrimoniaux à proximité
2,0 – <3,04,0 – <6,0Quelques bâtiments anciens à proximité
1,0 – <2,02,0 – <4,0Peu de bâtiments historiques à proximité
0,0 – <1,00,0 – <2,0Pas de bâtiments historiques à proximité

Bien-être​

Bien-être​

API (0,0–5,0)Affichage (0,0–10,0)Signification
4,5–5,09,0–10,0Variété exceptionnelle de services favorisant l'activité physique et l'alimentation saine à proximité
4,0 – <4,58,0 – <9,0Grande variété de services favorisant l'activité physique et l'alimentation saine à proximité
3,0 – <4,06,0 – <8,0Variété de services favorisant l'activité physique et l'alimentation saine à proximité
2,0 – <3,04,0 – <6,0Quelques services favorisant l'activité physique et l'alimentation saine à distance de marche
1,0 – <2,02,0 – <4,0Peu de services favorisant l'activité physique et l'alimentation saine à distance de marche
0,0 – <1,00,0 – <2,0Très peu ou pas de services favorisant l'activité physique et l'alimentation saine à proximité

GET /v3/scores​

Les scores de localisation pour un point de coordonnées précis, ainsi que pour le quartier, le quartier macro et la municipalité qui le contiennent, peuvent être récupérés à l'aide d'une requête de latitude/longitude.

Les scores pour le point de coordonnées latitude/longitude sont retournés sous forme de score sur 5, avec une précision au .5 près. Les scores de géographie pour le quartier, le quartier macro et la municipalité sont également retournés sous forme de score sur 5, mais avec une précision au .1 près.

GET /v3/scores

Cette API utilise l'authentification par jeton JWT. Ce jeton porteur (Bearer) JWT est ce qui est utilisé pour remplir l'en-tête Authorization ci-dessous.

Les instructions pour récupérer ce jeton se trouvent dans Premiers pas.

En-têteStatutDescription
AuthorizationrequisVotre jeton porteur récupéré depuis notre API d'autorisation, ex. Bearer eyJhbGci...
AcceptrequisLe type de données demandé; cette API retournera application/json.

Paramètres de requête​

Requête par latitude et longitude​

Le point de terminaison est interrogé en spécifiant une coordonnée lat/lng pour obtenir les scores à un endroit précis.

ParameterStatutDescription
latoptionnelUn nombre décimal entre -90 et 90, représentant la latitude.
lngoptionnelUn nombre décimal entre -180 et 180, représentant la longitude.
geography_levelsoptionnelUne liste de niveaux de géographie à inclure, par ex. 10,30. Si aucun niveau de géographie n'est fourni, aucun score de géographie ne sera retourné.

Disponibles : Quartier : 10
Quartier macro ou arrondissement : 20
Municipalité : 30
Code postal : 32
Subdivision de comté américaine : 35
Comté américain / équivalent de comté canadien (division de recensement) : 37
Région : 38
Région métropolitaine américaine : 40
includeoptionnelUne liste de ScoreNames à retourner, par ex. car_friendly,pedestrian_friendly. Si aucun nom n'est fourni, tous les scores inclus dans votre entente seront retournés.
languageoptionnelValeur de chaîne représentant le code de langue à deux lettres ISO 639-1 dans lequel retourner les scores, par ex. fr

Disponibles : en et fr
location_scores_roundingoptionnelLe type d'arrondi à appliquer aux scores retournés sous data.location. Soit .5 (par défaut) pour arrondir au 0,5 près, soit none, pour désactiver l'arrondi.

Requête de classement des unités géographiques par cote​

Le point de terminaison peut aussi renvoyer un classement des unités géographiques situées dans une ville ou une région métropolitaine, à l'aide des paramètres suivants :

ParamètreStatutDescription
withinoptionnelgeog_id d'une unité géographique de niveau 30 (ville ou municipalité) ou de niveau 40 (région métropolitaine), qui définit les limites à l'intérieur desquelles les unités géographiques sont classées selon une cote donnée.
includeoptionnelNom de la cote (un item de ScoreNames) selon laquelle classer les unités géographiques renvoyées, p. ex. cafes ou pedestrian_friendly. Un seul nom de cote est accepté lorsque le paramètre within est utilisé.
directionoptionnelASC (croissant) ou DESC (décroissant), pour indiquer l'ordre de tri des cotes.
Par défaut : DESC, de sorte que les unités géographiques ayant les cotes les plus élevées sont renvoyées en premier.
min_valueoptionnelValeur numérique minimale de la cote, comprise entre 0 et 5 inclusivement. Seules sont renvoyées les unités géographiques qui se trouvent dans celle indiquée par within et dont la cote précisée par include est supérieure ou égale à cette valeur.
max_valueoptionnelValeur numérique maximale de la cote, comprise entre 0 et 5 inclusivement. Seules sont renvoyées les unités géographiques qui se trouvent dans celle indiquée par within et dont la cote précisée par include est inférieure ou égale à cette valeur.
limitoptionnelNombre d'unités géographiques à renvoyer parmi celles qui se trouvent dans le geog_id indiqué par within, classées selon une seule valeur de cote par unité géographique.
Par défaut : 10
languageoptionnelValeur de chaîne représentant le code de langue à deux lettres ISO 639-1 dans lequel retourner les scores, par ex. fr

Disponibles : en et fr
location_scores_roundingoptionnelLe type d'arrondi à appliquer aux scores retournés sous data.location. Soit .5 (par défaut) pour arrondir au 0,5 près, soit none, pour désactiver l'arrondi.

Exemples d'utilisation​

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)
})

Exemple de réponse​

{
  "data": {
    "type": "scores",
    "location": {
      "transit_friendly": {
        "value": "4.5",
        "text": "Near a wide variety of rapid transit and/or frequent bus lines"
      },
      "quiet": { 
        "value": "1.0", 
        "text": "Multiple sources of noise nearby" 
      }
    },
    "geographies": [
      {
        "geog_id": "g30_f25dv0me",
        "name": "Westmount",
        "geog_level_type": "municipality",
        "scores": {
          "transit_friendly": {
            "value": "4.5",
            "text": "Near a wide variety of rapid transit and/or frequent bus lines"
          },
          "quiet": {
            "value": "2.7",
            "text": "Some sources of noise nearby"
          }
        }
      },
      // Plus other geography score objects
    ]
  },
  "meta": {
    "message": "Successfully called v3/scores API.",
    "type": "LocalLogic.API.Success",
    "statusCode": 200
  }
}

GET /v3/scores/{geog_id}​

Les scores de localisation pour une géographie précise (un quartier, un quartier macro, une municipalité, un code postal, un comté, etc.) peuvent être récupérés à l'aide de ce point de terminaison. Les scores représentent le score de localisation du ménage médian habitant le secteur : la moitié des ménages auront un score inférieur et l'autre moitié auront un score supérieur.

Les scores pour la géographie sont retournés aussi précisément que possible et ne sont pas arrondis.

GET /v3/scores/{geog_id}

En-tête​

Cette API utilise l'authentification par jeton JWT. Ce jeton porteur (Bearer) JWT est ce qui est utilisé pour remplir l'en-tête Authorization ci-dessous.

Les instructions pour récupérer ce jeton se trouvent dans Premiers pas.

En-têteStatutDescription
AuthorizationrequisVotre jeton porteur récupéré depuis notre API d'autorisation, ex. Bearer eyJhbGci...
AcceptrequisLe type de données demandé; cette API retournera application/json.

Paramètres de requête​

ParameterStatutDescription
includeoptionnelUne liste de ScoreNames à retourner, par ex. car_friendly,pedestrian_friendly. Si aucun nom n'est fourni, tous les scores inclus dans votre entente seront retournés.
languageoptionnelValeur de chaîne représentant le code de langue à deux lettres ISO 639-1 dans lequel retourner les scores, par ex. fr

Disponibles : en et fr

Exemples d'utilisation​

  require('node-fetch')('https://api.locallogic.co/v3/scores/g37_9zh9deu6', 
  {
    method: 'GET',
    headers: {
      Accept: 'application/json',
      Authorization: 'Bearer eyJhbGciOiJ...'
    }
  })
    .then(response => response.json())
    .then(body => {
      console.log(body)
    })
    .catch(error => {
      console.log(error)
    })

Exemple de réponse​

{
    "data": {
        "type": "scores",
        "scores": {
            "pedestrian_friendly": {
                "value": "3.389361",
                "text": "Many pleasant streets and pedestrian-oriented shops within a short walk. Meeting daily needs on foot is often practical"
            },
            "vibrant": {
                "value": "2.271424",
                "text": "Vibrant atmosphere at various times of the day"
            },
            "nightlife": {
                "value": "2.51681",
                "text": "Variety of bars within a short drive"
            },
            "high_schools": {
                "value": "2.95529",
                "text": "At least one high school within a 20-minute walk"
            },
            "daycares": {
                "value": "2.955288",
                "text": "At least one daycare within a short drive"
            },
            "cycling_friendly": {
                "value": "2.525079",
                "text": "Somewhat suitable for bicycle commuting and/or recreational cycling"
            },
            "transit_friendly": {
                "value": "2.600652",
                "text": "Transit is available for most trips"
            },
            "parks": {
                "value": "3.613697",
                "text": "Large amount of park space nearby"
            },
            "primary_schools": {
                "value": "3.75381",
                "text": "At least one elementary school within a 15-minute walk"
            },
            "car_friendly": {
                "value": "4.144336",
                "text": "Excellent access to freeways and/or major arteries, with a very low chance of parking problems"
            },
            "cafes": {
                "value": "1.23387",
                "text": "Some cafés within a short drive"
            },
            "wellness": {
                "value": "2.769637",
                "text": "Some amenities promoting health and activity within walking distance"
            },
            "restaurants": {
                "value": "2.332912",
                "text": "Variety of restaurants within a short drive"
            },
            "quiet": {
                "value": "2.245218",
                "text": "Some sources of noise nearby"
            },
            "groceries": {
                "value": "2.226187",
                "text": "Variety of groceries within a short drive"
            },
            "shopping": {
                "value": "2.359544",
                "text": "Variety of shops within a short drive"
            }
        }
    },
    "meta": {
        "message": "Successfully called v3/scores/{geog_id} API.",
        "type": "LocalLogic.API.Success",
        "statusCode": 200
    }
}
Comment cette donnée est calculée

Ce qu'ils mesurent — et ce qu'ils ne mesurent pas. Les Location Scores cotent les environs d'un point précis — la proximité et la fréquence du transport en commun, la quantité et la variété des épiceries à proximité, etc. En principe, plus les commodités sont proches et nombreuses, plus elles comptent. Ils ne mesurent pas les attributs propres à une propriété (prix, superficie, état), et un score lié aux écoles reflète l'accès aux écoles plutôt que leur qualité, laquelle constitue une couche de cotes distincte.

Mise à jour. Mensuelle; les scores fondés sur les points d'intérêt s'actualisent au rythme des données de PDI sous-jacentes, ainsi qu'au fil des mises à jour périodiques des données d'infrastructure (réseau routier, lignes de transport en commun, etc.).

Couverture. À l'échelle de l'adresse et de la géographie, partout aux États-Unis et au Canada. Un petit nombre de scores ont une couverture plus restreinte, en expansion active.

→ D'où proviennent nos données

Foire aux questions​

Que sont les Location Scores de Local Logic?

Les Location Scores sont 18 cotes lisibles et intuitives qui décrivent la vie à un endroit précis — de son potentiel piétonnier et de son accès au transport en commun jusqu'aux épiceries, cafés et écoles à proximité, en passant par le caractère silencieux, historique ou dynamique du secteur. Chaque cote est présentée sur une échelle de 0 à 10 et s'accompagne d'une description en langage clair, de sorte qu'elle peut être affichée telle quelle aux utilisateurs finaux, sans interprétation supplémentaire.

Comment les 18 Location Scores sont-ils organisés?

Les 18 scores sont regroupés en six catégories :

  • Transport - adapté aux piétons, adapté aux cyclistes, transport public, adapté aux voitures
  • Services - épiceries, magasins, cafés, restaurants, vie nocturne
  • Éducation - écoles secondaires, écoles primaires, garderies
  • Caractère - silencieux, historique, dynamisme
  • Nature - parcs, verdure
  • Bien-être - bien-être

Comment les Location Scores sont-ils calculés?

Chaque score est calculé à l'échelle de l'adresse à partir des caractéristiques qui entourent l'emplacement. En principe, plus les commodités sont proches et nombreuses, plus elles comptent — une épicerie au coin de la rue contribue davantage au score Épiceries qu'une épicerie à l'autre bout de la ville.

Pourquoi les scores vont-ils de 0 à 5 dans l'API, mais sont-ils affichés sur 10?

L'API retourne chaque Location Score sur une échelle de 0 à 5. Le SDK de Local Logic et les rapports de quartier doublent cette valeur pour l'afficher sur une échelle de 0 à 10, plus facile à lire et à comparer d'un coup d'œil pour les utilisateurs finaux. Les deux représentent le même score sous-jacent — 0 à 5 est la valeur brute de l'API, 0 à 10 en est la présentation.

À quels niveaux géographiques les scores sont-ils offerts?

Les Location Scores peuvent être obtenus pour un point latitude/longitude précis ou pour une géographie Local Logic par son identifiant. Les niveaux pris en charge sont : quartier (10), macroquartier/arrondissement (20), municipalité (30), code ZIP américain (32), subdivision de comté américaine (35), comté américain ou canadien ou équivalent (37), région (38) et région métropolitaine américaine (40). À l'échelle d'une géographie, un score représente l'expérience du ménage médian de ce secteur.

Que se passe-t-il lorsqu'aucun score n'existe pour un emplacement?

Lorsque Local Logic ne dispose pas d'information suffisante pour un emplacement, les scores manquants sont simplement omis de la réponse, et une requête pour un emplacement sans données retourne un 204 No Content (emplacement reconnu, rien à coter) ou un 404 Not Found. Un 204/404 signifie donc « aucune donnée ici », et non une erreur dans votre requête.

Comment fonctionnent les scores liés aux écoles?

Les Location Scores liés aux écoles — écoles primaires, écoles secondaires et garderies — reposent sur l'accès et la proximité : la distance de l'école la plus proche de ce type. Les cotes de qualité des écoles (notes alphabétiques) constituent une couche distincte, offerte via l'API Schools — actuellement aux États-Unis, ainsi qu'en Ontario et en Colombie-Britannique au Canada.

Les descriptions des scores sont-elles offertes en français?

Un Location Score est une valeur numérique, il n'est donc pas propre à une langue. Le paramètre language détermine la langue du texte descriptif qui accompagne chaque score, offert en anglais (en) et en français (fr).

Implémentations SDK​

Scores est utilisé par plusieurs SDK :

SDKDescription
Local Content SDKRécupère les scores pour un lieu donné, aux fins d'utilisation dans les catégories de points d'intérêt regroupées au sein du SDK.
NeighborhoodHighlights SDKRécupère les scores du quartier afin de calculer les faits saillants (meilleurs scores) du quartier.
NeighborhoodCharacteristics SDKRécupère tous les scores pertinents et disponibles pour le quartier donné.

Codes de réponse​

Lorsque vous appelez l'API de Local Logic, vous pouvez recevoir un code de réponse HTTP indiquant une erreur ou une absence de données. Ces erreurs sont expliquées ci-dessous.

En général, les codes d'erreur commençant par « 4 » sont dus à un appel d'API invalide et peuvent être corrigés de votre côté, alors que les codes d'erreur commençant par « 5 » sont dus à des erreurs de serveur (c'est-à-dire des problèmes de notre côté). Si vous recevez quelque chose qui n'est pas décrit ici, veuillez communiquer avec nous à support@locallogic.co.

204 - No Content

Ce « code d'erreur » n'en est pas un et se produit lorsque nous n'avons pas les données requises pour un emplacement précis. Par exemple, si vous envoyez une paire lat/lng pour obtenir des scores dans des régions inhabitées du nord du Canada, nous pouvons retourner une réponse 204 vide, car nous reconnaissons l'emplacement, mais nous ne calculons pas de scores dans des endroits aussi éloignés, donc il n'y a rien à retourner.

400 - BadRequest

Ce code d'erreur se produit lorsque les données saisies dans la requête sont incorrectes. Utilisez le champ detail de la réponse pour obtenir des précisions. Exemple :

{
  "code": "LocalLogic.API.BadRequest",
  "detail": "ValidationErrors: AroundEndpoint is invalid:\n\tinclude is invalid: \"bad_input\" is not an acceptable value: \"groceries\", \"restaurants\", \"nightlife\", \"cafes\", \"shopping\", \"daycares\", \"primary_schools\", \"high_schools\""
}

401 - Unauthorized

Ce code d'erreur se produit lorsque votre clé API ne peut pas accéder à certaines ressources ou à certains emplacements. Par exemple, certaines clés API ne peuvent accéder qu'à certains pays, états ou provinces. N'hésitez pas à communiquer avec nous pour plus d'information.

{
  "code": "LocalLogic.API.Unauthorized",
  "detail": "Your API KEY doesn't support this region"
}

403 - Forbidden

Ce code d'erreur se produit lorsque vous avez oublié d'inclure les identifiants de sécurité dans votre requête ou lorsque vous demandez un paramètre auquel vous n'avez pas accès.

{
  "message": "Forbidden"
}

404 - NotFound

Ce code d'erreur se produit lorsque nous n'avons pas de données pour l'emplacement demandé. Par exemple, si vous envoyez une paire lat/lng pour un emplacement en Antarctique, nous retournerons cette erreur, car nous n'avons pas (encore!) de données pour l'Antarctique.

{
  "code": "LocalLogic.API.NotFound",
  "detail": "No Location Scores found for this location."
}

422 - Unprocessable Entity

Ce code d'erreur est retourné lorsque les bons paramètres ont été envoyés, mais que les données qu'ils contiennent ne sont pas valides. Par exemple, si vous envoyez une paire lat/lng et que la latitude est invalide (c.-à-d. hors de la plage [-90, 90]) ou que la longitude est invalide (c.-à-d. hors de la plage [-180, 180]). Le message retourné expliquera le problème précis avec vos paramètres qui les rend invalides.

{
  "message": "Latitude must be within [-90, 90], Longitude must be within [-180, 180], Requires at least lat/lng pair, or geography_ids. None supplied.",
  "code": "LocalLogic.API.BadRequest",
  "statusCode": 422
}

429 - Too Many Requests

Ce code d'erreur peut être retourné lorsque vous devez limiter le débit de vos requêtes. À l'interne, nous établissons des limites qui dépassent toutes les limites contractuelles pouvant entraîner le retour de ce code d'erreur. Si vous avez des questions ou si vous voyez cette erreur, veuillez communiquer avec nous à support@locallogic.co.

500 - ServerError

Ce code d'erreur signifie qu'une erreur s'est produite de notre côté. N'hésitez pas à réessayer la même requête pour voir si le problème persiste. Si vous recevez beaucoup de ces erreurs, veuillez communiquer avec nous à support@locallogic.co.

{
  "code": "LocalLogic.API.ServerError",
  "detail": "No Location Scores found for this location."
}

502 - BadGateway

Ce code d'erreur signifie qu'une erreur provient de notre fournisseur infonuagique. N'hésitez pas à réessayer la même requête pour voir si le problème persiste.

{
  "message": "Internal server error"
}
Dernière mise à jour le