Places API allows you to lookup information on a particular place using a combination of the location name and details about the physical location. Attributes like address, city, region or even latitutde/longitude. You may request attributes from Safegraph Core, Geometry, or Pattern datasets.
Request Parameters: Query
query parameters are used to lookup POI details using Name and Location.
| Parameter | Description |
|---|---|
| location_name | Name of the location |
| street_address | Street Address |
| city | Name of the city |
| region | Name of the Region |
| postal_code | The numeric postal code |
| iso_country_code | ISO Country code |
| latitude | The latitude with a precision of at least 3 decimal points. |
| longitude | The longitude with a precision of at least 3 decimal points. |
Required Fields
When querying by location & address, it's necessary to have at least the following combination of fields to return a result:
location_name+street_address+city+region+iso_country_codelocation_name+street_address+postal_code+iso_country_codelocation_name+latitude+longitude+iso_country_code
query {
lookup(
query: {
location_name: "Taco Bell"
street_address: "710 3rd St"
city: "San Francisco"
region: "CA"
iso_country_code: "US"
}
) {
placekey
safegraph_core {
location_name
street_address
postal_code
phone_number
category_tags
}
}
}
{
"data": {
"lookup": {
"placekey": "224-222@5vg-7gv-d7q",
"safegraph_core": {
"location_name": "Taco Bell",
"street_address": "710 3rd St",
"postal_code": "94107",
"phone_number": "+14159791587",
"category_tags": [
"Counter Service",
"Late Night",
"Lunch",
"Fast Food",
"Drive Through",
"Breakfast",
"Mexican Food",
"Dinner"
]
}
}
},
"extensions": {
"row_count": 1,
"version_date": "1635494405__2021_10"
}
}