Module google_maps::places
source · Expand description
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::response::matched_substring::MatchedSubstring;
pub use crate::places::place_autocomplete::response::prediction::Prediction;
pub use crate::places::place_autocomplete::response::Response as AutocompleteResponse;
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::request::autocomplete_type::AutocompleteType;
pub use crate::places::place_autocomplete::request::Request as PlaceAutocompleteRequest;
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::secondary_hours_type::SecondaryHoursType;
pub use crate::places::status::Status;
Modules
"business_status"
field within the Places API Place response
object indicates the operational status of the place, if it is a business.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."type"
field within the Places API PlaceOpeningHours response
object describing the opening hours of a place."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.