Google Places
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 search, text search, place details, photos, and autocomplete predictions.
Documentation GitHub OpenAPI
OpenAPI Specification

openapi: 3.1.0
info:
  title: Google Places API (New)
  description: >-
    The 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.
  version: 1.0.0
  contact:
    name: Google
    url: https://developers.google.com/maps/documentation/places/web-service
servers:
  - url: https://places.googleapis.com/v1
paths:
  /places:searchNearby:
    post:
      operationId: searchNearbyPlaces
      summary: Google Places Nearby Search
      description: Search for places near a specified location.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NearbySearchRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
      tags:
        - places:searchNearby
  /places:searchText:
    post:
      operationId: searchTextPlaces
      summary: Google Places Text Search
      description: Search for places using a text query.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TextSearchRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
      tags:
        - places:searchText
  /places/{placeId}:
    get:
      operationId: getPlaceDetails
      summary: Google Places Place Details
      description: Get detailed information about a specific place.
      parameters:
        - name: placeId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Place'
      tags:
        - Places
  /places/{placeId}/photos/{photoReference}/media:
    get:
      operationId: getPlacePhoto
      summary: Google Places Place Photo
      description: Get a photo for a place.
      parameters:
        - name: placeId
          in: path
          required: true
          schema:
            type: string
        - name: photoReference
          in: path
          required: true
          schema:
            type: string
        - name: maxHeightPx
          in: query
          schema:
            type: integer
        - name: maxWidthPx
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: Photo media response
      tags:
        - Places
  /places:autocomplete:
    post:
      operationId: autocompletePlaces
      summary: Google Places Autocomplete
      description: Get place predictions based on partial text input.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AutocompleteRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AutocompleteResponse'
      tags:
        - Places:autocomplete
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: key
  schemas:
    Place:
      type: object
      properties:
        name:
          type: string
        id:
          type: string
        displayName:
          type: object
          properties:
            text:
              type: string
            languageCode:
              type: string
        types:
          type: array
          items:
            type: string
        formattedAddress:
          type: string
        location:
          $ref: '#/components/schemas/LatLng'
        rating:
          type: number
        userRatingCount:
          type: integer
        websiteUri:
          type: string
        regularOpeningHours:
          type: object
          properties:
            openNow:
              type: boolean
            periods:
              type: array
              items:
                type: object
        photos:
          type: array
          items:
            $ref: '#/components/schemas/Photo'
        reviews:
          type: array
          items:
            $ref: '#/components/schemas/Review'
    LatLng:
      type: object
      properties:
        latitude:
          type: number
        longitude:
          type: number
    Photo:
      type: object
      properties:
        name:
          type: string
        widthPx:
          type: integer
        heightPx:
          type: integer
        authorAttributions:
          type: array
          items:
            type: object
    Review:
      type: object
      properties:
        name:
          type: string
        rating:
          type: number
        text:
          type: object
          properties:
            text:
              type: string
            languageCode:
              type: string
        publishTime:
          type: string
    NearbySearchRequest:
      type: object
      properties:
        includedTypes:
          type: array
          items:
            type: string
        maxResultCount:
          type: integer
        locationRestriction:
          type: object
    TextSearchRequest:
      type: object
      properties:
        textQuery:
          type: string
        maxResultCount:
          type: integer
    AutocompleteRequest:
      type: object
      properties:
        input:
          type: string
        locationBias:
          type: object
    AutocompleteResponse:
      type: object
      properties:
        suggestions:
          type: array
          items:
            type: object
    SearchResponse:
      type: object
      properties:
        places:
          type: array
          items:
            $ref: '#/components/schemas/Place'
security:
  - ApiKeyAuth: []
tags:
  - name: Places
  - name: Places:autocomplete
  - name: places:searchNearby
  - name: places:searchText
Google Places API

Specifications

Schemas & Data

Other Resources

OpenAPI Specification
