Mapping Response Fields
Legend (in increasing order of billing rate)
- Google Basic Field / FSQ Core Data Field
- Google Atmosphere Field / FSQ Rich Data Field
| Google Places Data | FSQ Places Data |
|---|---|
| address_component | location → address |
| business_status | date_closed |
| formatted_address | location → address |
| adr_address | n/a |
| geometry | geocodes → roof |
| n/a | geocodes → road |
| n/a | geocodes → drop_off |
| n/a | geocodes → front_door |
| icon | categories → icon |
| name | name |
| photo | photos |
| place_id | fsq_id |
| plus_code | n/a |
| type | categories |
| url | n/a |
| utc_offset | timezone |
| vicinity | location → address |
| opening_hours / open_now | hours / hours → open_now |
| formatted_phone_number | tel |
| international_phone_number | tel |
| website | website |
| price_level | price |
| rating | rating |
| user_ratings_total | stats → total_ratings |
| reviews | tips |
| n/a | chains |
| n/a | related_places |
| n/a | distance |
| n/a | description |
| n/a | fax |
| n/a | |
| n/a | social_media |
| n/a | verified |
| n/a | hours_popular |
| n/a | stats → total_photos |
| n/a | stats → total_tips |
| n/a | popularity |
| n/a | rating |
| n/a | tastes |
Migrating Calls to Place Search
Google Nearby Search: lets you search for places within a specified area. You can refine your search request by supplying keywords or specifying the type of place you are searching for.
Google Text Search: returns information about a set of places based on a string — for example "pizza in New York" or "shoe stores near Ottawa" or "123 Main Street".
Foursquare Place Search: find places using a location and querying by name, category name, taste label, or chain name — for example "sushi in Los Angeles".
Comparing Endpoint Parameters
| Google Nearby & Text Search | FSQ Place Search |
|---|---|
| key | token (via header) |
| location | ll, near, or ne/sw |
| radius | radius |
| keyword | query |
| n/a | fields |
| minprice / maxprice | minprice, max_price (_coming soon) |
| name | query |
| opennow | openat (_coming soon) |
| rankby | sort |
| type | categories |
| pagetoken | pagination in header |
Sample Google Nearby Search call
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=40.67,-73.95&radius=1500&type=restaurant&keyword=burger&key={{gpapikey}}
Sample Foursquare Place Search call
https://api.foursquare.com/v3/places/search?ll=40.67,-73.95&query=burger&fields=geocodes,categories,name,hours,fsq_id,price,rating,stats,location