Google Places website screenshot

Google Places

The Google Places API is a service that accepts HTTP requests for location data through a variety of methods. It returns formatted location data and imagery about establishments, geographic locations, or prominent points of interest. Supports nearby search, text search, place details, place photos, and autocomplete.

1 APIs 0 Features
RestaurantGeolocationGoogleLocationsMapsPlacesPoints of Interest

APIs

Google Places API

The Places API (New) provides programmatic access to Google's database of places, including establishments, geographic locations, and points of interest. It supports nearby sear...

Collections

Pricing Plans

Rate Limits

Google Places Rate Limits

2 limits

RATE LIMITS

FinOps

Semantic Vocabularies

context Context

16 classes · 0 properties

JSON-LD

Google Places Api Context

24 classes · 57 properties

JSON-LD

API Governance Rules

Google Places API Rules

39 rules · 6 errors 20 warnings 13 info

SPECTRAL

JSON Structure

Author Attribution Structure

3 properties

JSON STRUCTURE

Autocomplete Request Structure

6 properties

JSON STRUCTURE

Autocomplete Response Structure

1 properties

JSON STRUCTURE

Circle Structure

2 properties

JSON STRUCTURE

Lat Lng Structure

2 properties

JSON STRUCTURE

Localized Text Structure

2 properties

JSON STRUCTURE

Nearby Search Request Structure

7 properties

JSON STRUCTURE

Opening Hours Structure

3 properties

JSON STRUCTURE

Photo Media Structure

2 properties

JSON STRUCTURE

Photo Structure

4 properties

JSON STRUCTURE

Place Structure

19 properties

JSON STRUCTURE

Review Structure

7 properties

JSON STRUCTURE

Search Response Structure

1 properties

JSON STRUCTURE

Suggestion Structure

2 properties

JSON STRUCTURE

Text Search Request Structure

9 properties

JSON STRUCTURE

Time Point Structure

3 properties

JSON STRUCTURE

Example Payloads

Author Attribution Example

3 fields

EXAMPLE

Autocomplete Request Example

6 fields

EXAMPLE

Circle Example

2 fields

EXAMPLE

Lat Lng Example

2 fields

EXAMPLE

Localized Text Example

2 fields

EXAMPLE

Opening Hours Example

3 fields

EXAMPLE

Photo Example

4 fields

EXAMPLE

Photo Media Example

2 fields

EXAMPLE

Place Example

19 fields

EXAMPLE

Review Example

7 fields

EXAMPLE

Search Response Example

1 fields

EXAMPLE

Suggestion Example

2 fields

EXAMPLE

Text Search Request Example

9 fields

EXAMPLE

Time Point Example

3 fields

EXAMPLE

Resources

👥
GitHubOrganization
GitHubOrganization
🔧
MCP Server
Tools
🔧
MCP Server (Grounding)
Tools
🚀
GettingStarted
GettingStarted
🔑
Authentication
Authentication
💰
Pricing
Pricing
🔗
RateLimits
RateLimits
🔗
Plans
Plans
🔗
FinOps
FinOps
🔗
JSONLD
JSONLD
🔗
Spectral
Spectral
🔗
Vocabulary
Vocabulary
💬
SupportTermsOfService
SupportTermsOfService

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Google Places API (New)
  version: 1.0.0
request:
  auth:
    type: apikey
    key: X-Goog-Api-Key
    value: '{{X-Goog-Api-Key}}'
    placement: header
items:
- info:
    name: Search
    type: folder
  items:
  - info:
      name: Google Places Search Nearby
      type: http
    http:
      method: POST
      url: https://places.googleapis.com/v1/places:searchNearby
      headers:
      - name: X-Goog-FieldMask
        value: ''
      body:
        type: json
        data: '{}'
    docs: Search for places within a specified geographic area, optionally filtered by one or more place types. Results can
      be ranked by popularity or by distance from a center point.
  - info:
      name: Google Places Search Text
      type: http
    http:
      method: POST
      url: https://places.googleapis.com/v1/places:searchText
      headers:
      - name: X-Goog-FieldMask
        value: ''
      body:
        type: json
        data: '{}'
    docs: Search for places using a free-form text query such as "spicy vegetarian food in Sydney". Returns a list of matching
      places ranked by relevance.
  - info:
      name: Google Places Autocomplete
      type: http
    http:
      method: POST
      url: https://places.googleapis.com/v1/places:autocomplete
      headers:
      - name: X-Goog-FieldMask
        value: ''
      body:
        type: json
        data: '{}'
    docs: Return place and query predictions in response to partial text input. Supports session tokens so that autocomplete
      keystrokes plus a subsequent Place Details request are billed as a single session.
- info:
    name: Places
    type: folder
  items:
  - info:
      name: Google Places Get Place Details
      type: http
    http:
      method: GET
      url: https://places.googleapis.com/v1/places/:placeId
      headers:
      - name: X-Goog-FieldMask
        value: ''
      params:
      - name: placeId
        value: ChIJN1t_tDeuEmsRUsoyG83frY4
        type: path
        description: The unique place identifier returned by search or autocomplete.
      - name: languageCode
        value: en
        type: query
        description: The language in which to return results (BCP-47 language tag).
      - name: regionCode
        value: US
        type: query
        description: The region code, specified as a CLDR two-character region code.
    docs: Retrieve comprehensive information about a specific place by its place ID, including address, location, opening
      hours, ratings, reviews, contact details, and photos.
  - info:
      name: Google Places Get Place Photo
      type: http
    http:
      method: GET
      url: https://places.googleapis.com/v1/places/:placeId/photos/:photoName/media
      params:
      - name: placeId
        value: ChIJN1t_tDeuEmsRUsoyG83frY4
        type: path
        description: The unique place identifier.
      - name: photoName
        value: AeJbb3eJ_example_reference
        type: path
        description: The photo resource reference returned in a place's photos array (the segment following photos/).
      - name: maxHeightPx
        value: '1080'
        type: query
        description: Maximum desired height of the image in pixels (1-4800).
      - name: maxWidthPx
        value: '1080'
        type: query
        description: Maximum desired width of the image in pixels (1-4800).
      - name: skipHttpRedirect
        value: 'true'
        type: query
        description: If true, returns a JSON response with the photo URI instead of redirecting.
    docs: Retrieve a photo for a place. The photo is referenced by the photo resource name returned in a Place Details, Nearby
      Search, or Text Search response. Returns the photo media or a redirect to the image bytes.
bundled: true