Google Places API
by developers.google.com
Location Information
Added on October 13th, 2014
Checked and working on November 15th, 2026
Visit developers.google.com →
What it does
The Google Places API gives information about places: search by text or nearby a location, get place details such as address, phone number, opening hours, ratings, reviews and photos, and add place autocomplete to your address and search fields. It uses the same data as Google Maps. Responses are JSON, and every request needs an API key from a Google Cloud project. Free only with billing turned on (a payment method is required), up to a monthly cap per type of request: 10,000 for Essentials calls such as autocomplete and basic place details, 5,000 for Pro and 1,000 for Enterprise; above the cap, paid per request.
At a glance
- API key
- Needed, free · More APIs with a free key
- Pricing
- Free only with billing turned on (a payment method is required), up to a monthly cap per type of request: 10,000 for Essentials calls such as autocomplete and basic place details, 5,000 for Pro and 1,000 for Enterprise; above the cap, paid per request.
- From the browser
- Yes (CORS)
- Formats
- JSON
- Interface
- REST, HTTP-GET
- Provider
- developers.google.com
- Last checked
- Working on November 15th, 2026
More information: https://developers.google.com/maps/documentation/places/web-service
Is this your service? Show that it is listed
Put this badge on your website or in your README; it links to this page. About the badge
Example request
curl
curl -X POST 'https://places.googleapis.com/v1/places:searchText' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
-d '{"textQuery": "museum in London"}'
JavaScript
const response = await fetch("https://places.googleapis.com/v1/places:searchText", {
method: 'POST',
headers: {
"Content-Type": "application/json",
"X-Goog-Api-Key": "YOUR_API_KEY",
"X-Goog-FieldMask": "places.displayName,places.formattedAddress",
},
body: JSON.stringify({"textQuery":"museum in London"}),
});
const data = await response.json();
console.log(data);
Python
import requests
response = requests.post(
"https://places.googleapis.com/v1/places:searchText",
headers={
"Content-Type": "application/json",
"X-Goog-Api-Key": "YOUR_API_KEY",
"X-Goog-FieldMask": "places.displayName,places.formattedAddress",
},
json={
"textQuery": "museum in London",
},
timeout=30,
)
print(response.json())
Replace YOUR_API_KEY with your own key. The JavaScript works in a web page as well as in Node.js 18 or newer.