google-places

Google Places

Search for places, restaurants, shops, and businesses.

When to Use

• "Find a restaurant near [location]"
• "Where's the nearest pharmacy?"
• "Best coffee shops in [city]"
• "Opening hours of [place]"

Text Search

curl -s -X POST "https://places.googleapis.com/v1/places:searchText" \
  -H "Content-Type: application/json" \
  -H "X-Goog-Api-Key: $GOOGLE_PLACES_API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,places.formattedAddress,places.rating,places.userRatingCount" \
  -d '{"textQuery": "pizza restaurants in Rome"}'

Place Details

curl -s "https://places.googleapis.com/v1/places/PLACE_ID" \
  -H "X-Goog-Api-Key: $GOOGLE_PLACES_API_KEY" \
  -H "X-Goog-FieldMask: displayName,formattedAddress,rating,currentOpeningHours,websiteUri,nationalPhoneNumber"

Nearby Search

curl -s -X POST "https://places.googleapis.com/v1/places:searchNearby" \
  -H "Content-Type: application/json" \
  -H "X-Goog-Api-Key: $GOOGLE_PLACES_API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,places.formattedAddress,places.rating" \
  -d '{
    "includedTypes": ["restaurant"],
    "maxResultCount": 10,
    "locationRestriction": {
      "circle": {
        "center": {"latitude": 41.9028, "longitude": 12.4964},
        "radius": 1000.0
      }
    }
  }'

Field Masks

Control which fields are returned (and billed):

• Basic: displayName,formattedAddress,location
• Contact: nationalPhoneNumber,websiteUri
• Atmosphere: rating,userRatingCount,reviews,currentOpeningHours

Notes

• Uses Places API (New) — pay per request
• FieldMask controls cost: request only needed fields
• Results language matches the query language