New pricing and product changes will go into effect starting June 11, 2018. For more information, check out the Guide for Existing Users.

Overview

The Places API for Web is a service that returns information about places using HTTP requests. Places are defined within this API as establishments, geographic locations, or prominent points of interest.

Introducing the API

The following place requests are available:

  • Place Search returns a list of places based on a user's location or search string.
  • Place Details returns more detailed information about a specific place, including user reviews.
  • Place Add supplements the data in Google's Places database with data from your application.
  • Place Photos provides access to the millions of place-related photos stored in Google's Place database.
  • Place Autocomplete automatically fills in the name and/or address of a place as users type.
  • Query Autocomplete provides a query prediction service for text-based geographic searches, returning suggested queries as users type.

Each of the services is accessed as an HTTP request, and returns either an JSON or XML response. All requests to a Places service must use the https:// protocol, and include an API key.

The Places API for Web uses a place ID to uniquely identify a place. For details about the format and usage of this identifier across the Places API for Web and other APIs, see the place ID documentation.

Policies and Terms

All applications that use the Places API for Web or Google Place Autocomplete must adhere to the requirements described in the Places API Policies and the Google Maps Platform APIs Terms of Service. The Places API for Web and Google Place Autocomplete share the usage quota as described in the Usage Limits and Billing documentation.

Send feedback about...