Place (beta)

Klasa Place

google.maps.places.Place zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {Place} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Place
Place(options)
Parametry: 
BetafindPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
Parametry: 
Wartość zwrotu:  Promise<{places:Array<Place>}>
Wyszukuje miejsce na podstawie podanego numeru telefonu. Zwraca tablicę w rzadkich przypadkach, gdy wiele miejsc może mieć ten sam numer telefonu.
BetafindPlaceFromQuery
findPlaceFromQuery(request)
Parametry: 
Wartość zwrotu:  Promise<{places:Array<Place>}>
Wyszukuje miejsce na podstawie podanego zapytania tekstowego. Zwraca tablicę w przypadkach, gdy zapytanie jest niejednoznaczne i zwraca więcej niż jedno miejsce. Ta metoda nie jest przeznaczona do wyszukiwań, w których oczekiwanych jest wiele wyników.
BetasearchByText
searchByText(request)
Parametry: 
Wartość zwrotu:  Promise<{places:Array<Place>}>
Wyszukiwanie miejsc na podstawie zapytania tekstowego.
addressComponents
Typ:  Array<AddressComponent> optional
Zbiór komponentów adresu dotyczących lokalizacji tego miejsca. pusty obiekt, jeśli nie ma znanych danych adresowych. undefined, jeśli serwer nie wywołał danych adresowych.
adrFormatAddress
Typ:  string optional
Adres miejsca przedstawiany w mikroformacie adr.
attributions
Typ:  Array<Attribution> optional
Tekst informacji, który będzie wyświetlany w przypadku tego wyniku wyszukiwania związanego z miejscem.
businessStatus
Typ:  BusinessStatus optional
Status operacyjny lokalizacji. null, jeśli stan jest nieznany. undefined, jeśli dane o stanie nie zostały wczytane z serwera.
displayName
Typ:  string optional
Wyświetlana nazwa lokalizacji. null, jeśli nie ma nazwy. undefined, jeśli dane o nazwie nie zostały wczytane z serwera.
formattedAddress
Typ:  string optional
pełny adres lokalizacji,
googleMapsURI
Typ:  string optional
URL oficjalnej strony Google dotyczącej tego miejsca. To jest strona należąca do Google, która zawiera najlepsze dostępne informacje o tym miejscu.
hasCurbsidePickup
Typ:  boolean optional
Informacja, czy miejsce odbioru jest dostępne na zewnątrz. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
hasDelivery
Typ:  boolean optional
Informacja, czy do tego miejsca są dostępne dostawy. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
hasDineIn
Typ:  boolean optional
czy to miejsce, w którym można zjeść posiłek; Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
hasTakeout
Typ:  boolean optional
Informacja, czy miejsce oferuje dania na wynos. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
hasWheelchairAccessibleEntrance
Typ:  boolean optional
Informacja, czy miejsce ma wejście dla niepełnosprawnych. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
iconBackgroundColor
Typ:  string optional
Domyślny szesnastkowy kod koloru dla kategorii miejsca.
id
Typ:  string
Niepowtarzalny identyfikator miejsca.
internationalPhoneNumber
Typ:  string optional
Numer telefonu danego miejsca w formacie międzynarodowym. Format międzynarodowy obejmuje kod kraju i jest poprzedzony znakiem plusa (+).
isReservable
Typ:  boolean optional
Określa, czy miejsce można zarezerwować. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
location
Typ:  LatLng optional
Pozycja miejsca.
nationalPhoneNumber
Typ:  string optional
Numer telefonu miejsca sformatowany zgodnie z lokalną konwencją numerów.
openingHours
Typ:  OpeningHours optional
photos
Typ:  Array<Photo> optional
Zdjęcia tego miejsca. Kolekcja będzie zawierać maksymalnie 10 obiektów Photo.
plusCode
Typ:  PlusCode optional
priceLevel
Typ:  PriceLevel optional
Poziom cen miejsca. Ta właściwość może zwracać dowolną z tych wartości:
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
Typ:  number optional
Ocena w przedziale od 1, 0 do 5, 0 na podstawie opinii użytkowników o danym miejscu.
requestedLanguage
Typ:  string optional
Żądany język dla tego miejsca.
requestedRegion
Typ:  string optional
Region, o który prosisz dla tego miejsca.
reviews
Typ:  Array<Review> optional
Lista opinii o tym miejscu.
servesBeer
Typ:  boolean optional
Czy w danym miejscu można napić się piwa. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
servesBreakfast
Typ:  boolean optional
Czy w tym miejscu serwowane jest śniadanie. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
servesBrunch
Typ:  boolean optional
Określa, czy w danym miejscu serwowane są brunche. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
servesDinner
Typ:  boolean optional
Czy w danym miejscu można zjeść kolację. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
servesLunch
Typ:  boolean optional
Określa, czy w danym miejscu serwowane są lunche. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
servesVegetarianFood
Typ:  boolean optional
Czy w danym miejscu można zjeść dania wegetariańskie. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
servesWine
Typ:  boolean optional
Czy w danym miejscu można napić się wina. Zwraca wartość „true” (prawda) lub „false” (fałsz), jeśli wartość jest znana. Zwraca wartość „null”, jeśli wartość jest nieznana. Zwraca wartość „undefined” (nieokreślona), jeśli żądanie tego pola nie zostało jeszcze przesłane.
svgIconMaskURI
Typ:  string optional
Identyfikator URI zasobu maski obrazu SVG, którego można użyć do reprezentowania kategorii miejsca.
types
Typ:  Array<string> optional
Tablica typów tego miejsca (np. ["political", "locality"] lub ["restaurant", "establishment"]).
userRatingCount
Typ:  number optional
Liczba ocen użytkowników, które przyczyniły się do powstania Place.rating danego miejsca.
utcOffsetMinutes
Typ:  number optional
Przesunięcie względem czasu UTC bieżącej strefy czasowej miejsca (w minutach). Na przykład czas wschodnioaustralijski standardowy (GMT+10) w czasie letnim jest przesunięty o 11 godzin do przodu, więc utc_offset_minutes będzie mieć wartość 660. W przypadku stref czasowych powyżej UTC przesunięcie jest ujemne. Na przykład utc_offset_minutes to -60 dla Wysp Zielonego Przylądka.
viewport
Typ:  LatLngBounds optional
Preferowany widoczny obszar wyświetlania tego miejsca na mapie.
websiteURI
Typ:  string optional
Wiarygodna witryna dotycząca tego miejsca, np. strona główna firmy.
BetafetchFields
fetchFields(options)
Parametry: 
Wartość zwrotu:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Parametry: 
  • dateDate optional
Wartość zwrotu:  Promise<Date optional>
Oblicza datę reprezentującą wartość next OpeningHoursTime. Zwraca nieokreśloną liczbę, jeśli dane są niewystarczające do obliczenia wyniku lub jeśli miejsce nie działa.
BetaisOpen
isOpen([date])
Parametry: 
  • dateDate optional wartość domyślna to teraz.
Wartość zwrotu:  Promise<boolean optional>
Sprawdź, czy miejsce jest otwarte w określonym dniu i godzinie. Utraca wartość undefined, jeśli znane dane lokalizacji są niewystarczające, aby to obliczyć, np. jeśli godziny otwarcia nie są zarejestrowane.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  Object obiekt JSON ze wszystkimi żądanymi właściwościami Place.

Interfejs PlaceOptions

google.maps.places.PlaceOptions interfejs

Opcje tworzenia miejsca.

id
Typ:  string
Niepowtarzalny identyfikator miejsca.
requestedLanguage optional
Typ:  string optional
Identyfikator języka, w którym należy zwracać szczegóły. Zobacz listę obsługiwanych języków.
requestedRegion optional
Typ:  string optional
Kod regionu regionu użytkownika. Może to mieć wpływ na to, które zdjęcia mogą zostać zwrócone, a także na inne kwestie. Kod regionu akceptuje dwuznaczną wartość ccTLD („domena najwyższego poziomu”). Większość kodów domen ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD w Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie oznacza to „Wielka Brytania i Irlandia Północna”).

klasa AddressComponent

google.maps.places.AddressComponent zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {AddressComponent} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

longText
Typ:  string optional
Pełny tekst komponentu adresu.
shortText
Typ:  string optional
Skrócony, krótki tekst danego komponentu adresu.
types
Typ:  Array<string>
Tablica ciągów oznaczających typ tego komponentu adresu. Listę prawidłowych typów znajdziesz tutaj.

Atrybucja

google.maps.places.Attribution zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {Attribution} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

provider
Typ:  string optional
Tekst informacji, który będzie wyświetlany w przypadku tego wyniku wyszukiwania związanego z miejscem.
providerURI
Typ:  string optional

Interfejs FetchFieldsRequest

google.maps.places.FetchFieldsRequest interfejs

Opcje pobierania pól miejsc.

fields
Typ:  Array<string>
Lista pól do pobrania.
sessionToken optional
Typ:  AutocompleteSessionToken optional
Unikalne odwołanie używane do łączenia żądania szczegółów z sesją autouzupełniania.

Zajęcia OpeningHours

google.maps.places.OpeningHours zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {OpeningHours} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

periods
Okresy otwarcia obejmujące każdy dzień tygodnia od niedzieli w kolejności chronologicznej. Nie obejmuje dni, w których Miejsce nie jest otwarte.
weekdayDescriptions
Typ:  Array<string>
Tablica 7 ciągów znaków reprezentujących sformatowane godziny otwarcia dla każdego dnia tygodnia. Usługa Miejsca odpowiednio sformatuje i zlokalizuje godziny otwarcia pod kątem aktualnego języka. Kolejność elementów w tej tablicy zależy od języka. W przypadku niektórych języków tydzień rozpoczyna się w poniedziałek, a w innych – w niedzielę.

OpeningHoursPeriod

google.maps.places.OpeningHoursPeriod zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {OpeningHoursPeriod} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

close
Typ:  OpeningHoursPoint optional
Godzina zamknięcia miejsca.
open
Godzina otwarcia miejsca.

Zajęcia OpeningHoursPoint

google.maps.places.OpeningHoursPoint zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {OpeningHoursPoint} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

day
Typ:  number
Dzień tygodnia jako liczba z zakresu [0, 6], zaczynający się od niedzieli. Na przykład 2 oznacza wtorek.
hour
Typ:  number
Godzina OpeningHoursPoint.time jako liczba w zakresie [0, 23]. Dane będą podawane w strefie czasowej miejsca.
minute
Typ:  number
Minuta wartości OpeningHoursPoint.time jako liczba w zakresie [0, 59]. Dane będą podawane w strefie czasowej miejsca.

Zajęcia Photo

google.maps.places.Photo zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {Photo} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

authorAttributions
Tekst oznaczenia, który będzie wyświetlany dla tego zdjęcia.
heightPx
Typ:  number
Wysokość zdjęcia w pikselach.
widthPx
Typ:  number
Szerokość zdjęcia w pikselach.
getURI
getURI([options])
Parametry: 
Wartość zwrotu:  string
Zwraca adres URL obrazu odpowiadający określonym opcjom.

Klasa AuthorAttribution

google.maps.places.AuthorAttribution zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {AuthorAttribution} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

displayName
Typ:  string
Imię i nazwisko autora tego wyniku.
photoURI
Typ:  string optional
Identyfikator URI zdjęcia autora w przypadku tego wyniku. Ta funkcja nie zawsze jest dostępna.
uri
Typ:  string optional
Identyfikator URI profilu autora w przypadku tego wyniku.

Klasa PlusCode

google.maps.places.PlusCode zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {PlusCode} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

compoundCode
Typ:  string optional
Kod plus o 1/8000 stopnia i 1/8000 stopnia, gdzie pierwsze 4 znaki (numer kierunkowy) są pomijane i zastąpione opisem lokalizacji. Na przykład „9G8F+5W Zurych, Szwajcaria”.
globalCode
Typ:  string optional
Kod plus oznaczający 1/8000 stopnia i 1/8000 stopnia. np. „8FVC9G8F+5W”.

Klasa Review

google.maps.places.Review zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {Review} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

authorAttribution
Typ:  AuthorAttribution optional
Recenzent.
publishTime
Typ:  Date optional
rating
Typ:  number optional
Ocena tej opinii, liczbą od 1,0 do 5,0 (włącznie).
relativePublishTimeDescription
Typ:  string optional
Ciąg sformatowany ostatnio czas, w którym podano czas sprawdzania w stosunku do bieżącego czasu, w formie odpowiedniej dla danego języka i kraju. Na przykład „miesiąc temu”.
text
Typ:  string optional
Tekst opinii.
textLanguageCode
Typ:  string optional
Kod języka IETF wskazujący język, w którym napisana jest opinia. Pamiętaj, że ten kod zawiera tylko główny tag języka bez żadnego dodatkowego tagu wskazującego kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczone tagiem 'en', a nie „en-AU” czy „en-UK”.

Stałe PriceLevel

google.maps.places.PriceLevel stałe

Enum poziomów cen dla obiektów Place.

Aby uzyskać dostęp, zadzwoń pod numer const {PriceLevel} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

Interfejs SearchByTextRequest

google.maps.places.SearchByTextRequest interfejs

Interfejs żądania BetaPlace.searchByText.

fields
Typ:  Array<string>
Pola, które mają być uwzględnione w odpowiedzi, za które będą naliczane opłaty. Jeśli przekażesz pole ['ALL'], wszystkie dostępne pola zostaną zwrócone i zapłacone (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult. Zagnieżdżone pola można określać za pomocą ścieżek punktowych (np. "geometry.location").
includedType optional
Typ:  string optional
Żądany typ miejsca. Pełna lista obsługiwanych typów: https://developers.google.com/maps/documentation/places/web-service/place-types. Obsługiwany jest tylko 1 uwzględniony typ. Zobacz SearchByTextRequest.useStrictTypeFiltering
isOpenNow optional
Typ:  boolean optional
Wartość domyślna: false
Służy do ograniczenia wyszukiwania do obecnie otwartych miejsc.
language optional
Typ:  string optional
Szczegóły miejsca będą wyświetlane w preferowanym języku (jeśli jest dostępny). Domyślnie zostanie ustawiony język ustawiony w przeglądarce. Aktualna lista obsługiwanych języków: https://developers.google.com/maps/faq#languagesupport.
locationBias optional
Region do przeszukania. Lokalizacja jest odchyleniem, co oznacza, że mogą być zwracane wyniki dotyczące jej okolicy. Tego ustawienia nie można ustawić razem z ograniczeniem lokalizacji.
locationRestriction optional
Region do przeszukania. Ta lokalizacja jest ograniczeniem, co oznacza, że wyniki spoza danej lokalizacji nie będą zwracane. Tego ustawienia nie można ustawić razem z locationBias.
maxResultCount optional
Typ:  number optional
Maksymalna liczba wyników do zwrócenia. Wartość ta musi mieścić się w przedziale od 1 do 20.
minRating optional
Typ:  number optional
Odfiltrowuje wyniki, których średnia ocena użytkowników jest wyraźnie niższa od tego limitu. Prawidłowa wartość musi być liczbą zmiennoprzecinkową między 0 a 5 (włącznie) z częstotliwością 0,5, tj. [0, 0,5; 1,0; ... , 5,0] włącznie. Ocena danych wejściowych zostanie zaokrąglona w górę do najbliższej wielokrotności 0,5(górny pułap). Na przykład ocena 0,6 eliminuje wszystkie wyniki z oceną mniejszą niż 1,0.
priceLevels optional
Typ:  Array<PriceLevel> optional
Służy do ograniczenia wyszukiwania do miejsc oznaczonych jako określone poziomy cen. Możesz wybrać dowolne kombinacje poziomów cen. Domyślnie wszystkie poziomy cen.
query optional
Typ:  string optional
rankBy optional
Typ:  SearchByTextRankBy optional
Wartość domyślna: SearchByTextRankBy.DISTANCE
sposób ustalania kolejności wyników w odpowiedzi;
region optional
Typ:  string optional
Kod Unicode kraju/regionu (CLDR) lokalizacji, z której pochodzi żądanie. Służy on do wyświetlania szczegółowych informacji o miejscu, takich jak nazwa miejsca z danego regionu, jeśli jest dostępna. Parametr może wpływać na wyniki w zależności od obowiązującego prawa. Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Pamiętaj, że 3-cyfrowe kody regionów nie są obecnie obsługiwane.
textQuery optional
Typ:  string optional
Wymagane. Zapytanie tekstowe do wyszukiwania tekstowego.
useStrictTypeFiltering optional
Typ:  boolean optional
Wartość domyślna: false
Służy do ustawiania ścisłego filtrowania typów w polu SearchByTextRequest.includedType. Jeśli zasada ma wartość Prawda, zwracane są tylko wyniki tego samego typu.

SearchByTextRankBy

google.maps.places.SearchByTextRankBy stałe

Wyliczenie rankinguBy dla obiektu SearchByTextRequest.

Aby uzyskać dostęp, zadzwoń pod numer const {SearchByTextRankBy} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

DISTANCE Ranking wyników według odległości.
RELEVANCE Ranking wyników według trafności.