Place

Place class

google.maps.places.Place class

This class implements PlaceOptions.

Access by calling const {Place} = await google.maps.importLibrary("places").
See Libraries in the Maps JavaScript API.
Place
Place(options)
Parameters: 
searchByText
searchByText(request)
Parameters: 
Return Value:  Promise<{places:Array<Place>}>
Text query based place search.
searchNearby
searchNearby(request)
Parameters: 
Return Value:  Promise<{places:Array<Place>}>
Search for nearby places.
accessibilityOptions
Type:  AccessibilityOptions optional
Accessibility options of this Place. undefined if the accessibility options data have not been called for from the server.
addressComponents
Type:  Array<AddressComponent> optional
The collection of address components for this Place’s location. Empty object if there is no known address data. undefined if the address data has not been called for from the server.
adrFormatAddress
Type:  string optional
The representation of the Place’s address in the adr microformat.
allowsDogs
Type:  boolean optional
attributions
Type:  Array<Attribution> optional
Data providers that must be shown for the Place.
businessStatus
Type:  BusinessStatus optional
The location's operational status. null if there is no known status. undefined if the status data has not been loaded from the server.
displayName
Type:  string optional
The location's display name. null if there is no name. undefined if the name data has not been loaded from the server.
displayNameLanguageCode
Type:  string optional
The language of the location's display name. null if there is no name. undefined if the name data has not been loaded from the server.
editorialSummary
Type:  string optional
The editorial summary for this place. null if there is no editorial summary. undefined if this field has not yet been requested.
editorialSummaryLanguageCode
Type:  string optional
The language of the editorial summary for this place. null if there is no editorial summary. undefined if this field has not yet been requested.
evChargeOptions
Type:  EVChargeOptions optional
EV Charge options provided by the place. undefined if the EV charge options have not been called for from the server.
formattedAddress
Type:  string optional
The locations’s full address.
fuelOptions
Type:  FuelOptions optional
Fuel options provided by the place. undefined if the fuel options have not been called for from the server.
googleMapsURI
Type:  string optional
URL of the official Google page for this place. This is the Google-owned page that contains the best available information about the Place.
hasCurbsidePickup
Type:  boolean optional
Whether a place has curbside pickup. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
hasDelivery
Type:  boolean optional
Whether a place has delivery. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
hasDineIn
Type:  boolean optional
Whether a place has dine in. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
hasLiveMusic
Type:  boolean optional
hasMenuForChildren
Type:  boolean optional
hasOutdoorSeating
Type:  boolean optional
hasRestroom
Type:  boolean optional
hasTakeout
Type:  boolean optional
Whether a place has takeout. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
iconBackgroundColor
Type:  string optional
The default HEX color code for the place's category.
id
Type:  string
The unique place id.
internationalPhoneNumber
Type:  string optional
The Place’s phone number in international format. International format includes the country code, and is prefixed with the plus (+) sign.
isGoodForChildren
Type:  boolean optional
isGoodForGroups
Type:  boolean optional
isGoodForWatchingSports
Type:  boolean optional
isReservable
Type:  boolean optional
Whether a place is reservable. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
location
Type:  LatLng optional
The Place’s position.
nationalPhoneNumber
Type:  string optional
The Place’s phone number, formatted according to the number's regional convention.
parkingOptions
Type:  ParkingOptions optional
Options of parking provided by the place. undefined if the parking options data have not been called for from the server.
paymentOptions
Type:  PaymentOptions optional
Payment options provided by the place. undefined if the payment options data have not been called for from the server.
photos
Type:  Array<Photo> optional
Photos of this Place. The collection will contain up to ten Photo objects.
plusCode
Type:  PlusCode optional
postalAddress
Type:  PostalAddress optional
priceLevel
Type:  PriceLevel optional
The price level of the Place. This property can return any of the following values
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
priceRange
Type:  PriceRange optional
The price range for this Place. endPrice could be unset, which indicates a range without upper bound (e.g. "More than $100").
primaryType
Type:  string optional
The location's primary type. null if there is no type. undefined if the type data has not been loaded from the server.
primaryTypeDisplayName
Type:  string optional
The location's primary type display name. null if there is no type. undefined if the type data has not been loaded from the server.
primaryTypeDisplayNameLanguageCode
Type:  string optional
The language of the location's primary type display name. null if there is no type. undefined if the type data has not been loaded from the server.
rating
Type:  number optional
A rating, between 1.0 to 5.0, based on user reviews of this Place.
regularOpeningHours
Type:  OpeningHours optional
requestedLanguage
Type:  string optional
The requested language for this place.
requestedRegion
Type:  string optional
The requested region for this place.
reviews
Type:  Array<Review> optional
A list of reviews for this Place.
servesBeer
Type:  boolean optional
Whether a place serves beer. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
servesBreakfast
Type:  boolean optional
Whether a place serves breakfast. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
servesBrunch
Type:  boolean optional
Whether a place serves brunch. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
servesCocktails
Type:  boolean optional
servesCoffee
Type:  boolean optional
servesDessert
Type:  boolean optional
servesDinner
Type:  boolean optional
Whether a place serves dinner. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
servesLunch
Type:  boolean optional
Whether a place serves lunch. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
servesVegetarianFood
Type:  boolean optional
Whether a place serves vegetarian food. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
servesWine
Type:  boolean optional
Whether a place serves wine. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown. Returns 'undefined' if this field has not yet been requested.
svgIconMaskURI
Type:  string optional
URI to the svg image mask resource that can be used to represent a place’s category.
types
Type:  Array<string> optional
An array of types for this Place (for example, ["political", "locality"] or ["restaurant", "establishment"]).
userRatingCount
Type:  number optional
The number of user ratings which contributed to this Place’s Place.rating.
utcOffsetMinutes
Type:  number optional
The offset from UTC of the Place’s current timezone, in minutes. For example, Austrialian Eastern Standard Time (GMT+10) in daylight savings is 11 hours ahead of UTC, so the utc_offset_minutes will be 660. For timezones behind UTC, the offset is negative. For example, the utc_offset_minutes is -60 for Cape Verde.
viewport
Type:  LatLngBounds optional
The preferred viewport when displaying this Place on a map.
websiteURI
Type:  string optional
The authoritative website for this Place, such as a business' homepage.
openingHours
Type:  OpeningHours optional
hasWiFi
Type:  boolean optional
fetchFields
fetchFields(options)
Parameters: 
Return Value:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Parameters: 
  • date:  Date optional
Return Value:  Promise<Date optional>
Calculates the Date representing the next OpeningHoursTime. Returns undefined if the data is insufficient to calculate the result, or this place is not operational.
BetaisOpen
isOpen([date])
Parameters: 
  • date:  Date optional Defaults to now.
Return Value:  Promise<boolean optional>
Check if the place is open at the given datetime. Resolves with undefined if the known data for the location is insufficient to calculate this, e.g. if the opening hours are unregistered.
toJSON
toJSON()
Parameters:  None
Return Value:  Object a JSON object with all the requested Place properties.

PlaceOptions interface

google.maps.places.PlaceOptions interface

Options for constructing a Place.
id
Type:  string
The unique place id.
requestedLanguage optional
Type:  string optional
A language identifier for the language in which details should be returned. See the list of supported languages.
requestedRegion optional
Type:  string optional
A region code of the user's region. This can affect which photos may be returned, and possibly other things. The region code accepts a ccTLD ("top-level domain") two-character value. Most ccTLD codes are identical to ISO 3166-1 codes, with some notable exceptions. For example, the United Kingdom's ccTLD is "uk" (.co.uk) while its ISO 3166-1 code is "gb" (technically for the entity of "The United Kingdom of Great Britain and Northern Ireland").

AccessibilityOptions class

google.maps.places.AccessibilityOptions class

Access by calling const {AccessibilityOptions} = await google.maps.importLibrary("places").
See Libraries in the Maps JavaScript API.
hasWheelchairAccessibleEntrance
Type:  boolean optional
Whether a place has a wheelchair accessible entrance. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown.
hasWheelchairAccessibleParking
Type:  boolean optional
Whether a place has wheelchair accessible parking. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown.
hasWheelchairAccessibleRestroom
Type:  boolean optional
Whether a place has a wheelchair accessible restroom. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown.
hasWheelchairAccessibleSeating
Type:  boolean optional
Whether a place offers wheelchair accessible seating. Returns 'true' or 'false' if the value is known. Returns 'null' if the value is unknown.