Google Places API Migration How-To

Mapping Response Fields

Legend (in increasing order of billing rate)

  1. Google Basic Field / FSQ Core Data Field
  2. Google Contact Field / FSQ Extended Data Field
  3. Google Atmosphere Field / FSQ Rich Data Field
Google Places DataFSQ Places Data
address_componentlocation → address
business_statusdate_closed
formatted_addresslocation → address
adr_addressn/a
geometrygeocodes → roof
n/ageocodes → road
n/ageocodes → drop_off
n/ageocodes → front_door
iconcategories → icon
namename
photophotos
place_idfsq_id
plus_coden/a
typecategories
urln/a
utc_offsettimezone
vicinitylocation → address
opening_hours / open_nowhours / hours → open_now
formatted_phone_numbertel
international_phone_numbertel
websitewebsite
price_levelprice
ratingrating
user_ratings_totalstats → total_ratings
reviewstips
n/achains
n/arelated_places
n/adistance
n/adescription
n/afax
n/aemail
n/asocial_media
n/averified
n/ahours_popular
n/astats → total_photos
n/astats → total_tips
n/apopularity
n/arating
n/atastes

back to top

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 SearchFSQ Place Search
keytoken (via header)
locationll, near, or ne/sw
radiusradius
keywordquery
n/afields
minprice / maxpriceminprice, max_price (_coming soon)
namequery
opennowopenat (_coming soon)
rankbysort
typecategories
pagetokenpagination 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
Sign In