Places API

Get location data for over 200 million places, and add place details, search, and autocomplete to your apps.


Get Started

Start building with the Places API.

Get started with Google Maps Platform

Create an account, generate an API key, and start building.

Choose your API version

Places supports two API versions: Places API and Places API (New), the next generation version of the APIs. Learn how to choose the version that is right for you.

Learn about place IDs

Place IDs uniquely identify a place in the Google Places database and on Google Maps.

Make your first Text Search (New) request

Return a place information based on text input, such as a name, address, or phone number.

Places Library in Maps JavaScript API

Add place search and autocomplete functionality to your applications, letting users find places based on a text query or phone number.

Learn about place icons

Request and display icons for various types of places.

Features for Places API (New)

Learn about core features of the Places API (New).

Nearby Search (New)

Search for matching place types within the specified area.

Text Search (New)

Search for place information based on a text search string.

Place Details (New)

Get details about a particular establishment or point of interest.

Place Photos (New)

Add high-quality photos of places to your application.

Autocomplete (New)

Get place predictions and query predictions in response to an input string.

Example apps

Run live code samples on your local machine and favorite code playgrounds with the Maps JavaScript API.

Place search

Use thefindPlaceFromQuery() method to locate a place, and add a marker to the map.

Place details

Use thegetDetails() method to retrieve Place Details for a particular place.

Place search pagination

Fetch additional pages of place search results.

Place autocomplete

Return place predictions in response to text searches.

Place autocomplete address form

Capture selected address components for a place, and use them to populate an address form.

Place autocomplete hotel search

Show all of the hotels in a specified place on a map, with on-click details for each hotel.

Help & support

Get help. Give help. Join the community.

Stack Overflow

Get help. Give Help. Build Maps karma.

Issue Tracker

Report a bug or open a feature request.

Platform status

Find out about platform incidents and outages.

Support

Get help from the Google Maps Platform team.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-27 UTC.