Location Information

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.
  • API
  • HTTP-GET
  • JSON
  • REST

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

Listed on Free Web Services

developers.google.com
Google Places API

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.

Did it work for you?

Tell us what you found when you tried Google Places API.