Google Places API

https://developers.google.com/places/documentation/

Getting Started

Looking to use this service in a JavaScript application? Check out the Places Library of the Google Maps API v3.The Google Places API is a service that returns information about Places — defined within this API as establishments, geographic locations, or prominent points of interest — using HTTP requests. Place requests specify locations as latitude/longitude coordinates.

  1. Introducing the API
  2. Authentication
  3. Requirements and Usage Limits

Introducing the API

The following Place requests are available:

  • Place Searches return a list of Places based on a user’s location or search string.
  • Place Details requests return more detailed information about a specific Place, including user reviews.
  • Place Actions allow you to supplement the data in Google’s Places Database with data from your application. You can schedule Events, add and remove Places, or weight Place rankings from user activity with Place Bumps.
  • Place Photos gives you access to the millions of Place related photos stored in Google’s Place database.
  • Places Autocomplete can be used to provide autocomplete functionality for text-based geographic searches, by returning Places as you type.
  • Query Autocomplete can be used to provide a query prediction service for text-based geographic searches, by returning suggested queries as you type.

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

Authentication

The Google Places API uses an API key to identify your application. API keys are managed through the Google APIs Console. You’ll need your own API Key before you can begin using the API. To activate the Places API and create your key:

  1. Visit the APIs Console at https://code.google.com/apis/console and log in with your Google Account.
  2. A default project called API Project is created for you when you first log in to the APIs Console. You can use the project, or create a new one by clicking the API Projectbutton at the top of the window and selecting CreateMaps API for Business customers must use the API project created for them as part of their Places for Business purchase.
  3. Click the Services link from the left-hand menu.
  4. Click the Status switch next to the Places API entry. The switch slides to On.
  5. Click API access from the left navigation. Your key is listed in the Simple API Access section.

Places API Enterprise Customers

Some features of the Places API — such as review summaries, and certain request filters — requires additional licensing, available as part of a Places API enterprise license.You can verify that your account has been enabled for Places API enterprise features as follows:

  1. Visit the APIs Console and log in with your Google Account.
  2. Select the project that was created for you when you signed up.The project name will start with Google Maps APIs for Business.
  3. Click the Services link from the left-hand menu.
  4. The Places API – Zagat Content service should be enabled. Note that only the initial owner of the project will be able to see the Places API – Zagat Content service.
  5. The Places API service should be disabled.

Usage Limits and Requirements

All applications that use the Google Places or Google Places Autocomplete APIs must adhere to the requirements described in the Developer Policies and the Google Maps/Google Earth API Terms of Service. The Google Places API and the Google Places Autocomplete API share a usage quota as described in the Usage Limits documentation.