Typologies

StableOffert en anglais seulementÉ.-U. 🇺🇸 et Canada 🇨🇦Disponible via MCP 🔌

Description

Interrogez des emplacements pour obtenir une catégorisation précise du type d'environnement bâti, basée sur une combinaison des données et informations géolocalisées de Local Logic, à l'échelle des États-Unis et du Canada, ainsi que sur la densité de population et la densité des ménages localisées.

Local Logic a catégorisé plus d'un demi-milliard d'emplacements en Amérique du Nord en fonction de leur densité de population et de leur "accès à tout" (défini comme l'accessibilité aux cafés, épiceries, restaurants, commerces, lieux de divertissement, établissements de conditionnement physique, services de santé, soins personnels, pharmacies, commerces locaux, vie nocturne et animaleries). À partir de ces données, chaque emplacement habité au Canada et aux États-Unis est catégorisé selon son accessibilité et sa densité.

Ce point de terminaison peut être utilisé pour adapter les informations de localisation et l'expérience client selon le type d'environnement dans lequel se trouve un emplacement. Par exemple, dans les cœurs urbains denses, il peut être plus pertinent de mettre en évidence la distance jusqu'à l'arrêt de transport en commun le plus proche, tandis que pour les zones dépendantes de l'automobile, la disponibilité de stationnement pourrait être plus pertinente.

Typologies de l'environnement bâti de Local Logic

Typologie	Définition	Exemples
urban (high access)	Dynamique, avec un accès très élevé aux commerces et services	New York City : Manhattan, la majeure partie de Brooklyn, la majeure partie du Bronx, Hoboken-Union City-Weehawken (NJ) Denver, CO : Le corridor du centre-ville autour du 16th St Mall Vancouver, Canada : La majeure partie du centre-ville de Vancouver, Mount Pleasant, Commercial Drive, le quartier des affaires de Vancouver, le secteur commercial de Terminal Ave, Granville Island
main street hub	Très favorable aux piétons, avec un bon accès (mais pas très élevé) aux commerces et services	NYC : Pelham Bay, le centre-ville de Mt. Vernon, Coney Island, le centre-ville de Hempstead, Stapleton Heights (Staten Island) Denver : South Broadway à Baker, Larimer St au nord du centre-ville, E 17th Ave à City Park West Vancouver : West Broadway à Kitsilano, Kerrisdale Village, le centre-ville et Uptown de New Westminster
pedestrian oriented dense	Bon accès aux commerces et services pour la vie quotidienne, avec des commodités principalement orientées vers les piétons La densité de population dépasse 5 000/km2	NYC : Une grande partie de Whitestone (Queens), Port Richmond (Staten Island), Eastchester (le Bronx), le secteur résidentiel de Kearny (NJ) Denver : Capitol Hill, Speer, Union Station à l'ouest du centre-ville Vancouver : Kitsilano, Kerrisdale, Kensington-Cedar Cottage
pedestrian oriented semi or low density	Bon accès aux commerces et services pour la vie quotidienne, avec des commodités principalement orientées vers les piétons La densité de population est inférieure à 5 000/km2, avec une forte proportion de maisons unifamiliales détachées	NYC : Garden City (NY), Elmwood Park (NJ), une grande partie de Bronxville, certaines parties d'East New York Denver : Sunnyside, Sloan Lake, Washington Park, Platt Park Vancouver : Westside : Arbutus Ridge, Oakridge, Shaughnessy
mall oriented dense	Bon accès aux commerces et services pour la vie quotidienne, avec des commodités principalement situées dans des centres commerciaux et des mails commerciaux La densité de population dépasse 5 000/km2	NYC : North Bayonne (NJ), le centre-ville de White Plains Denver : Certaines parties de Glendale, les secteurs commerciaux de Colfax et E Mississippi à Aurora, East 29th Avenue Town Center Vancouver : Les secteurs Metrotown et Brentwood de Burnaby, les centres suburbains de Richmond et Surrey
mall oriented semi or low density	Bon accès aux commerces et services pour la vie quotidienne, avec des commodités principalement situées dans des centres commerciaux et des mails commerciaux La densité de population est inférieure à 5 000/km2, avec une forte proportion de maisons unifamiliales détachées	NYC : Springfield et Union (NJ); Hartsdale (NY); Glenbrook, Stamford (CT) Denver : Montclair, Hilltop, le nord d'Englewood, Centennial près du Tech Center Vancouver : Secteurs résidentiels près des centres suburbains de Richmond et Surrey
transit friendly	Bon accès au transport en commun, mais pas à distance de marche d'un large éventail de commodités	NYC : Le sud de Secaucus (NJ); Arrochar, Staten Island (NY); Cambria Heights, Queens (NY); près des stations LIRR à Long Island Denver : Autour de plusieurs stations de train; 40th et Colorado (A), Perry-Sheridan-Lamar (W), Commerce City / 72nd Ave (N) Vancouver : UBC, SFU, le sud de Vancouver et le sud de Burnaby
car dependent	Densité supérieure à la densité rurale, mais sans bon accès au transport en commun ni bonne accessibilité piétonne aux commodités La densité de population dépasse 150/km2	NYC : Long Island à l'est du comté de Nassau, Belle Harbor (Queens), Dumont (NJ), Mount Pleasant (NY) Denver : Westminster, Thornton, Cherry Hills Village, Columbine, Golden Vancouver : La majeure partie de Richmond, Surrey, Delta, Coquitlam
rural / other	Zones rurales entourées de forêts et de terres agricoles, et zones non classifiables à faible densité comme les parcs, les aéroports, les développements industriels La densité de population est inférieure à 150/km2	NYC : Matinecock (NY); Bedminster (NJ); Redding (CT); Central Park; l'aéroport LaGuardia Denver : North Washington industriel, City Park, Coal Creek, Sedalia Vancouver : Zones agricoles de Richmond et Delta

GET /v3/typologies

GET /v3/typologes

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ête	Statut	Description
Authorization	requis	Votre jeton porteur récupéré depuis notre API d'autorisation, ex. Bearer eyJhbGci...
Accept	requis	Le type de données demandé; cette API retournera application/json.

Chaîne de requête

Paramètre	État	Description
lat	optionnel	Un nombre décimal entre -90 et 90, représentant la latitude.
lng	optionnel	Un nombre décimal entre -180 et 180, représentant la longitude.

Exemples d'utilisation

NodeJS

  require('node-fetch')('https://api.locallogic.co/v3/typologies?' + new URLSearchParams({
    lat: 45.508888,
    lng: -73.561668
  }), {
    method: 'GET',
    headers: {
      Accept: 'application/json',
      Authorization: 'Bearer eyJhbGciOiJ...'
    }
  })
    .then(response => response.json())
    .then(body => {
      console.log(body)
    })
    .catch(error => {
      console.log(error)
    })

Python

import requests

response = requests.get(
  "https://api.locallogic.co/v3/typologies",
  headers={
    "Accept": "application/json",
    "Authorization": "Bearer eyJhbGciOiJ..."},
  params={
    "lat": "45.508888",
    "lng": "-73.561668"
  }
)

print(response.json())

Exemple de réponse

{
    "data": {
        "pedestrian oriented semi or low density": {
            "population_per_square_km": 1773.408174201228,
            "households_per_square_km": 1002.3215604699958
        }
    },
    "meta": {
        "message": "Successfully called v3/typologies API. This is a Beta endpoint. Its interface can change without notice.",
        "type": "LocalLogic.API.Success",
        "statusCode": 200
    }
}

GET /v3/typologies/{geohash-7}

Cette version de la requête utilise un géohash à 7 chiffres aux États-Unis ou au Canada pour déterminer la typologie de l'environnement bâti. Voici un exemple de géohash à 7 chiffres contenant le bureau de Local Logic à Montréal, au Canada.

GET /v3/typologes/{geohash-7}

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ête	Statut	Description
Authorization	requis	Votre jeton porteur récupéré depuis notre API d'autorisation, ex. Bearer eyJhbGci...
Accept	requis	Le type de données demandé; cette API retournera application/json.

Exemples d'utilisation

NodeJS

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

Python

import requests

response = requests.get(
  "https://api.locallogic.co/v3/typologies/f25dvv7",
  headers={
    "Accept": "application/json",
    "Authorization": "Bearer eyJhbGciOiJ..."}
)

print(response.json())

Exemple de réponse

{
    "data": {
        "urban (high access)": {
            "population_per_square_km": 11837.653186533324,
            "households_per_square_km": 9085.643049730807
        }
    },
    "meta": {
        "message": "Successfully called v3/typologies API. This is a Beta endpoint. Its interface can change without notice.",
        "type": "LocalLogic.API.Success",
        "statusCode": 200
    }
}

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