Migrate from Google Places API to FSQ Places API

Table of Contents

  1. Mapping Response Fields
  2. Migrating Calls to Place Search
    1. Google's Nearby Search
    2. Google's Text Search

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

email

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

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 Search

FSQ Place Search

key

token (via header)

location

ll, near, or ne/sw

radius

radius

keyword

query

n/a

fields

minprice / maxprice

min_price, max_price (coming soon)

name

query

opennow

open_at (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

back to top


Did this page help you?