Module google_maps::places

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

Before you begin

• Before you begin: Before you start using the Places API, you need a project with a billing account and the Places API enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you’ll always have someone with these roles available to your team. To learn more, see Set up in Cloud Console.

Note: Server-side and client-side libraries

• The Places API is also available with the Java Client, Python Client, Go Client and Node.js Client for Google Maps Services. The Places API and the client libraries are for use in server applications.

• If you’re building a client-side application, take a look at the Places SDK for Android, the Places SDK for iOS, and the Places Library, Maps JavaScript API.

Introducing the API

The following place requests are available:

• Place Search (Not yet implemented in this client.) returns a list of places based on a user’s location or searchstring.

• Place Details (Not yet implemented in this client.) returns more detailed information about a specific place, including user reviews.

• Place Photos (Not yet implemented in this client.) 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.

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

Policies and Terms

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

For quota and pricing information for the Places API and Place Autocomplete service, see the Places API Usage and Billing documentation.

Re-exports

• pub use crate::places::place_autocomplete::error::Error as AutocompleteError;
• pub use crate::places::place_autocomplete::request::autocomplete_type::AutocompleteType;
• pub use crate::places::place_autocomplete::request::Request as PlaceAutocompleteRequest;
• pub use crate::places::place_autocomplete::response::matched_substring::MatchedSubstring;
• pub use crate::places::place_autocomplete::response::prediction::Prediction;
• pub use crate::places::place_autocomplete::response::status::Status as AutocompleteStatus;
• pub use crate::places::place_autocomplete::response::structured_format::StructuredFormat;
• pub use crate::places::place_autocomplete::response::term::Term;
• pub use crate::places::place_autocomplete::response::Response as AutocompleteResponse;
• pub use crate::places::place_autocomplete::request::Request as QueryAutocompleteRequest;
• pub use crate::places::business_status::BusinessStatus;
• pub use crate::places::error::Error;
• pub use crate::places::place::Place;
• pub use crate::places::place_editorial_summary::PlaceEditorialSummary;
• pub use crate::places::place_opening_hours::PlaceOpeningHours;
• pub use crate::places::place_opening_hours_period::PlaceOpeningHoursPeriod;
• pub use crate::places::place_opening_hours_period_detail::PlaceOpeningHoursPeriodDetail;
• pub use crate::places::place_photo::PlacePhoto;
• pub use crate::places::place_review::PlaceReview;
• pub use crate::places::place_special_day::PlaceSpecialDay;
• pub use crate::places::rank_by::RankBy;
• pub use crate::places::secondary_hours_type::SecondaryHoursType;
• pub use crate::places::status::Status;

Modules

• business_status
  The business_status field within the Places API Place response object indicates the operational status of the place, if it is a business.
• error
  Places API error types and error messages.
• place
  Attributes describing a place. Not all attributes will be available for all place types.
• place_autocomplete
  The Place Autocomplete service is a web service that returns place predictions. The request specifies a textual search string and optional geographic bounds. The service can be used to provide autocomplete functionality for text-based geographic searches, by returning places such as businesses, addresses and points of interest as a user types.
• place_details
  Once you have a place_id from a Place Search, you can request more details about a particular establishment or point of interest by initiating a Place Details request. A Place Details request returns more comprehensive information about the indicated place such as its complete address, phone number, user rating and reviews.
• place_editorial_summary
  Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.
• place_opening_hours
  An object describing the opening hours of a place.
• place_opening_hours_period
  An object describing the opening hours of a place.
• place_opening_hours_period_detail
  An object describing the opening hours of a place.
• place_photo
  A photo of a Place. The photo can be accesed via the
• place_review
  A review of the place submitted by a user.
• place_search
  The Place Search service lets you search for place information using a variety of categories, including establishments, prominent points of interest, and geographic locations. You can search for places either by proximity or a text string. A Place Search returns a list of places along with summary information about each place; additional information is available via a Place Details query.
• place_special_day
  An object describing the opening hours of a place on special days or holidays.
• query_autocomplete
  The Query Autocomplete service is used to provide a query prediction for text-based geographic searches, by returning suggested queries as you type.
• rank_by
  The "type" field within the Places API PlaceOpeningHours response object describing the opening hours of a place.
• secondary_hours_type
  The "type" field within the Places API PlaceOpeningHours response object describing the opening hours of a place.
• status
  The "status" field within the Places API Place Search response objects contain the status of the request, and may contain debugging information to help your request is not working.