Places Service

klasa PlacesService

google.maps.places.PlacesService class

Zawiera metody związane z wyszukiwaniem miejsc i pobieraniem informacji o nich.

Dostęp przez połączenie telefoniczne pod numer const {PlacesService} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.
PlacesService
PlacesService(attrContainer)
Parametry: 
Tworzy nową instancję PlacesService, która renderuje atrybuty w określonym kontenerze.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parametry: 
Zwracana wartość: brak
Pobiera listę miejsc na podstawie numeru telefonu. W większości przypadków na liście wyników powinien znajdować się tylko 1 element, ale jeśli żądanie jest niejednoznaczne, może zwrócić więcej niż 1 wynik. Elementy PlaceResult przekazane do wywołania zwrotnego są podzbiorami pełnej wartości PlaceResult. Twoja aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, dzwoniąc pod numer PlacesService.getDetails i przekazując wartość PlaceResult.place_id dla danego miejsca.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parametry: 
Zwracana wartość:  brak
Pobiera listę miejsc na podstawie ciągu znaków zapytania. W większości przypadków na liście wyników powinien znajdować się tylko 1 element, ale jeśli żądanie jest niejednoznaczne, może zwrócić więcej niż 1 wynik. PlaceResult przekazane do wywołania zwrotnego to podzbiory pełnego PlaceResult. Twoja aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, dzwoniąc pod numer PlacesService.getDetails i przekazując wartość PlaceResult.place_id dla danego miejsca.
getDetails
getDetails(request, callback)
Parametry: 
Zwracana wartość:  brak
Pobiera szczegóły miejsca z identyfikatorem placeId.
nearbySearch
nearbySearch(request, callback)
Parametry: 
Zwracana wartość: brak
Pobiera listę miejsc w pobliżu określonej lokalizacji na podstawie słowa kluczowego lub typu. Lokalizacja musi być zawsze określona, albo przez przekazanie parametru LatLngBounds, albo parametrów location i radius. Elementy PlaceResult przekazane do wywołania zwrotnego są podzbiorami pełnej wartości PlaceResult. Aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, wysyłając żądanie szczegółów miejsca z PlaceResult.place_id dla wybranego miejsca. Obiekt PlaceSearchPagination może służyć do pobierania dodatkowych stron wyników (null, jeśli jest to ostatnia strona wyników lub jeśli jest tylko 1 strona wyników).
textSearch
textSearch(request, callback)
Parametry: 
Zwracana wartość: brak
Pobiera listę miejsc na podstawie ciągu znaków zapytania (np. „pizza w Warszawie” lub „sklepy obuwnicze w pobliżu Warszawy”). Parametry lokalizacji są opcjonalne. Gdy lokalizacja jest określona, wyniki są zachowywane tylko względem wyników znajdujących się w pobliżu, a nie tylko znajdujących się w obrębie danego obszaru. Użyj operatora textSearch, gdy chcesz wyszukać miejsca za pomocą dowolnego ciągu znaków, oraz w przypadkach, gdy nie chcesz ograniczać wyników wyszukiwania do konkretnej lokalizacji. Obiektu PlaceSearchPagination można użyć do pobierania dodatkowych stron wyników (wartość null, jeśli jest to ostatnia strona wyników lub jeśli istnieje tylko jedna strona wyników).

Interfejs PlaceDetailsRequest

google.maps.places.PlaceDetailsRequestinterfejs

Zapytanie o szczegóły miejsca, które ma zostać przesłane do PlacesService.
placeId
Typ:  string
Identyfikator miejsca, którego dotyczy żądanie szczegółów.
fields optional
Typ:  Array<string> optional
Pola, które mają być uwzględnione w odpowiedzi z informacjami, za które zostanie naliczona opłata. Jeśli nie określisz żadnych pól lub nie przekażesz parametru ['ALL'], zwrócone i obciążone zostaną wszystkie dostępne pola (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz tutaj: PlaceResult. Zagnieżdżone pola można określić za pomocą ścieżek kropki (np. "geometry.location").
language optional
Typ:  string optional
Identyfikator języka, w którym mają być zwracane informacje. Zobacz listę obsługiwanych języków.
region optional
Typ:  string optional
Kod regionu użytkownika. Może to mieć wpływ na to, które zdjęcia mogą zostać zwrócone, a także na inne aspekty. Kod regionu może mieć 2-znakową wartość domeny krajowej najwyższego poziomu. Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD Wielkiej Brytanii to „uk” (.co.uk), a jej kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”).
sessionToken optional
Typ:  AutocompleteSessionToken optional
Unikalne odwołanie służące do zgrupowania żądania szczegółów z sesją autouzupełniania.

Interfejs FindPlaceFromPhoneNumberRequest

google.maps.places.FindPlaceFromPhoneNumberRequestinterfejs

Miejsce znajdowania miejsca z żądania wyszukiwania tekstowego zostanie wysłane na adres PlacesService.findPlaceFromPhoneNumber.
fields
Typ:  Array<string>
Pola do uwzględnienia w odpowiedzi, za które będzie naliczana opłata. Jeśli zostanie przekazane ['ALL'], wszystkie dostępne pola zostaną zwrócone i zapłacone (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz tutaj: PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek kropkowych (np. "geometry.location").
phoneNumber
Typ:  string
Numer telefonu miejsca, które chcesz wyszukać. Format musi być E.164.
language optional
Typ:  string optional
Identyfikator języka języka, w którym powinny być zwracane imiona i nazwiska oraz adresy, jeśli jest to możliwe. Zobacz listę obsługiwanych języków.
locationBias optional
Typ:  LocationBias optional
Odchylenie używane podczas wyszukiwania miejsca. Wynik będzie sprzyjać podanej wartości LocationBias, ale nie będzie się do niej ograniczać.

Interfejs FindPlaceFromQueryRequest

google.maps.places.FindPlaceFromQueryRequestinterfejs

Wysłać do PlacesService.findPlaceFromQuery prośbę o wyszukiwanie miejsca z zapytania o wyszukiwanie tekstowe.
fields
Typ:  Array<string>
Pola do uwzględnienia w odpowiedzi, za które będą naliczane opłaty. Jeśli podasz parametr ['ALL'], zwrócone i obciążone zostaną wszystkie dostępne pola (nie zalecamy tego w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz tutaj: PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek kropkowych (np. "geometry.location").
query
Typ:  string
Zapytanie. Na przykład nazwę lub adres miejsca.
language optional
Typ:  string optional
Identyfikator języka, w którym mają być zwracane nazwy i adresy (jeśli to możliwe). Zobacz listę obsługiwanych języków.
locationBias optional
Typ:  LocationBias optional
Ustawienie używane podczas wyszukiwania Miejsca. Wynik będzie sprzyjać podanej wartości LocationBias, ale nie będzie się do niej ograniczać.

interfejs PlaceSearchRequest

google.maps.places.PlaceSearchRequestinterfejs

Zapytanie dotyczące wyszukiwania miejsc do wysłania do PlacesService.
bounds optional
Granice, w których mają być wyszukiwane Miejsca. Jeśli skonfigurowana jest zasada bounds, wartości location i radius będą ignorowane.
keyword optional
Typ:  string optional
Wyszukiwane hasło, które należy dopasować do wszystkich dostępnych pól, w tym m.in. do nazwy, typu i adresu, a także do opinii klientów i innych treści firm zewnętrznych.
language optional
Typ:  string optional
Identyfikator języka, w którym mają być zwracane nazwy i adresy (jeśli to możliwe). Zobacz listę obsługiwanych języków.
location optional
Typ:  LatLng|LatLngLiteral optional
Lokalizacja, w pobliżu której mają być wyszukiwane miejsca.
maxPriceLevel optional
Typ:  number optional
Ogranicza wyniki do miejsc o określonym lub niższym poziomie ceny. Prawidłowe wartości to od 0 (najtańsze) do 4 (najdroższe) włącznie. Wartość nie może być mniejsza niż minPrice , jeśli została określona.
minPriceLevel optional
Typ:  number optional
Ogranicza wyniki tylko do miejsc o określonym lub wyższym poziomie ceny. Prawidłowe wartości mieszczą się w zakresie od 0 (najbardziej przystępna cena) do 4 (najdroższa) włącznie. Musi być równa lub mniejsza niż maxPrice, jeśli została określona.
name optional
Typ:  string optional
Odpowiednik: keyword. Wartości w tym polu są łączone z wartościami w polu keyword i przekazywane w ramach tego samego wyszukiwanego ciągu znaków.
openNow optional
Typ:  boolean optional
Ogranicza wyniki tylko do miejsc, które są w tej chwili otwarte.
radius optional
Typ:  number optional
Odległość od danej lokalizacji, w której wyszukiwane są Miejsca, w metrach. Maksymalna dozwolona wartość to 50 000.
rankBy optional
Typ:  RankBy optional
Domyślnie: RankBy.PROMINENCE
Określa metodę rankingowania, która ma być używana podczas zwracania wyników. Pamiętaj, że gdy parametr rankBy ma wartość DISTANCE, musisz podać wartość location, ale nie możesz podać wartości radius ani bounds.
type optional
Typ:  string optional
Wyszukiwanie miejsc danego typu. Typ jest tłumaczony na język lokalny lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli podasz również zapytanie, zostanie ono połączone z ciągiem znaków lokalnego typu. Wyniki innego typu są usuwane z odpowiedzi. Użyj tego pola, aby przeprowadzić wyszukiwania kategorialne niezależne od języka i regionu. Prawidłowe typy znajdziesz tutaj.

Interfejs TextSearchRequest

google.maps.places.TextSearchRequestinterfejs

Prośba o wyszukiwanie tekstu zostanie wysłana do PlacesService.
bounds optional
Granice używane do ukierunkowania wyników podczas wyszukiwania miejsc (opcjonalnie). Jeśli skonfigurowana jest zasada bounds, wartości location i radius będą ignorowane. Wyniki nie będą ograniczone do tych, które mieszczą się w tych granicach, ale wyniki w nich mieszczące się będą miały wyższą pozycję.
language optional
Typ:  string optional
Identyfikator języka, w którym mają być zwracane nazwy i adresy (jeśli to możliwe). Zobacz listę obsługiwanych języków.
location optional
Typ:  LatLng|LatLngLiteral optional
Środek obszaru używany do odchylenia wyników przy wyszukiwaniu miejsc.
query optional
Typ:  string optional
Wyszukiwane hasło użyte w żądaniu. Na przykład nazwa miejsca („Wieża Eiffla”), kategoria, po której następuje nazwa lokalizacji („pizza w Gdańsku”), lub nazwa miejsca, po którym następuje jego wyodrębnienie („Starbucks w Sydney”).
radius optional
Typ:  number optional
Promień obszaru używany do odchylenia wyników przy wyszukiwaniu miejsc (w metrach).
region optional
Typ:  string optional
Kod regionu, który ma być uwzględniony w wynikach. Kod regionu może mieć 2-znakową wartość domeny krajowej najwyższego poziomu. Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład ccTLD Wielkiej Brytanii to „uk” (.co.uk), a jej kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”).
type optional
Typ:  string optional
Wyszukuje miejsca określonego typu. Typ jest tłumaczony na język lokalizacji docelowej lokalizacji i używany jako ciąg znaków zapytania. Jeśli podasz również zapytanie, zostanie ono połączone z ciągiem znaków lokalnego typu. Wyniki innego typu nie są uwzględniane w odpowiedzi. Użyj tego pola, aby przeprowadzić wyszukiwanie według kategorii niezależnie od języka i regionu. Prawidłowe typy znajdziesz tutaj.

Stałe RankBy

stałe: google.maps.places.RankBy

Opcje rankingu dla PlaceSearchRequest.

Uzyskaj dostęp, dzwoniąc pod numer const {RankBy} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.
DISTANCE Ustawia wyniki według odległości od lokalizacji.
PROMINENCE Rankingi ustalają wyniki na podstawie widoczności.

LocationBias typedef

google.maps.places.LocationBias typedef

LocationBias to nieostre ograniczenie lub sugestia, których można używać podczas wyszukiwania miejsc. Wyniki mogą pochodzić spoza określonego obszaru. Aby użyć adresu IP bieżącego użytkownika jako biasu, możesz podać ciąg znaków "IP_BIAS". Uwaga: jeśli używasz Circle, musisz zdefiniować środek i promień.

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction reprezentuje ścisłe ograniczenie stosowane podczas wyszukiwania miejsc.

LatLngBounds|LatLngBoundsLiteral

stałe PlacesServiceStatus,

stałe: google.maps.places.PlacesServiceStatus

Stan zwracany przez PlacesService po zakończeniu wyszukiwania. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.places.PlacesServiceStatus.OK.

Dostęp przez połączenie telefoniczne pod numer const {PlacesServiceStatus} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
INVALID_REQUEST To żądanie było nieprawidłowe.
NOT_FOUND Nie znaleziono miejsca, do którego się odwołujesz.
OK Odpowiedź zawiera prawidłowy wynik.
OVER_QUERY_LIMIT Aplikacja przekroczyła limit żądań.
REQUEST_DENIED Aplikacja nie ma zezwolenia na korzystanie z: PlacesService.
UNKNOWN_ERROR Nie udało się przetworzyć żądania PlacesService z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się udać.
ZERO_RESULTS Nie znaleziono żadnych wyników dla tego zapytania.

Interfejs PlaceSearchPagination

google.maps.places.PlaceSearchPaginationinterfejs

Obiekt służący do pobierania dodatkowych stron wyników wyszukiwania w usłudze Places.
hasNextPage
Typ:  boolean
Wskazuje, czy są dostępne kolejne wyniki. true gdy jest dostępna dodatkowa strona wyników.
nextPage
nextPage()
Parametry: brak
Zwracana wartość:  void
Pobiera następną stronę wyników. Używa tej samej funkcji wywołania zwrotnego, która została podana w pierwszym żądaniu wyszukiwania.

Interfejs PlaceResult

google.maps.places.PlaceResultinterfejs

Definiuje informacje o miejscu.
address_components optional
Zbiór elementów adresu dla lokalizacji danego Miejsca. Dostępne tylko w PlacesService.getDetails.
adr_address optional
Typ:  string optional
Adres miejsca w mikroformacie adresu. Dostępna tylko w usłudze PlacesService.getDetails.
aspects optional
Typ:  Array<PlaceAspectRating> optional
aspekty tego miejsca ocenione na podstawie opinii użytkowników w usługach Google i Zagat. Oceny są przyznawane w skali od 0 do 30.
business_status optional
Typ:  BusinessStatus optional
Flaga wskazująca stan działania Miejsca, jeśli jest to firma (wskazuje, czy miejsce jest czynne czy zamknięte tymczasowo lub na stałe). Jeśli nie ma dostępnych danych, flaga nie występuje w odpowiedziach na wyszukiwanie ani w odpowiedziach z szczegółami.
formatted_address optional
Typ:  string optional
Pełny adres miejsca.
formatted_phone_number optional
Typ:  string optional
Numer telefonu miejsca sformatowany zgodnie z regionalną konwencją obowiązującą w przypadku numeru. Dostępne tylko w PlacesService.getDetails.
geometry optional
Typ:  PlaceGeometry optional
Informacje o geometrii Miejsca.
html_attributions optional
Typ:  Array<string> optional
Tekst informacji o pochodzeniu wyświetlany w przypadku tego wyniku dotyczącego miejsca. Dostępne wartości html_attributions są zawsze zwracane niezależnie od żądania typu fields i muszą być wyświetlane.
icon optional
Typ:  string optional
Adres URL zasobu graficznego, który może służyć do reprezentowania kategorii tego miejsca.
icon_background_color optional
Typ:  string optional
Kolor tła do użycia z ikoną Miejsca. Zobacz też PlaceResult.icon_mask_base_uri.
icon_mask_base_uri optional
Typ:  string optional
Skrócony adres URL maski ikony. Dostęp do różnych typów ikon uzyskujesz, dodając na końcu rozszerzenie pliku (np. .svg lub .png).
international_phone_number optional
Typ:  string optional
Numer telefonu Miejsca w formacie międzynarodowym. Format międzynarodowy zawiera kod kraju i jest poprzedzony znakiem plusa (+). Dostępne tylko w PlacesService.getDetails.
name optional
Typ:  string optional
Nazwa Miejsca. Uwaga: w przypadku miejsc wpisanych przez użytkownika jest to tekst w postaci surowej, tak jak został wpisany przez użytkownika. Zachowaj ostrożność podczas korzystania z tych danych, ponieważ użytkownicy o złośliwych zamiarach mogą próbować ich użyć jako wektora ataków polegających na wstrzyknięciu kodu (patrz http://en.wikipedia.org/wiki/Code_injection).
opening_hours optional
Typ:  PlaceOpeningHours optional
Określa, kiedy miejsce zostanie otwarte lub zamknięte.
permanently_closed optional
Typ:  boolean optional
Flaga z informacją, czy miejsce jest zamknięte na stałe czy tymczasowo. Jeśli miejsce działa lub nie są dostępne żadne dane, w odpowiedzi nie pojawi się flaga.
photos optional
Typ:  Array<PlacePhoto> optional
Zdjęcia tego miejsca. Kolekcja będzie zawierać maksymalnie 10 obiektów PlacePhoto.
place_id optional
Typ:  string optional
Unikalny identyfikator miejsca.
plus_code optional
Typ:  PlacePlusCode optional
Określa kody Open Location lub „kody plus” dla Miejsca.
price_level optional
Typ:  number optional
Poziom ceny Miejsca na skali od 0 do 4. Poziomy cen są interpretowane w ten sposób:
  • 0: bezpłatny
  • 1: niedrogie
  • 2: umiarkowana
  • 3: drogi
  • 4: bardzo drogie
rating optional
Typ:  number optional
Ocena od 1, 0 do 5, 0 na podstawie opinii użytkowników o tym miejscu.
reviews optional
Typ:  Array<PlaceReview> optional
lista opinii o tym miejscu; Dostępne tylko w PlacesService.getDetails.
types optional
Typ:  Array<string> optional
Tablica typów tego Miejsca (na przykład ["political", "locality"] lub ["restaurant", "establishment"]).
url optional
Typ:  string optional
Adres URL oficjalnej strony Google danego miejsca. To strona należąca do Google, która zawiera najlepsze dostępne informacje o danym Miejscu. Dostępna tylko w usłudze PlacesService.getDetails.
user_ratings_total optional
Typ:  number optional
Liczba ocen użytkowników, które przyczyniły się do PlaceResult.rating danego Miejsca.
utc_offset optional
Typ:  number optional
Odchylenie bieżącej strefy czasowej Miejsca od czasu UTC w minutach. Na przykład w Sydney w Australii w czasie letnim jest 11 godzin więcej niż w UTC, więc utc_offset będzie 660. W przypadku stref czasowych, które są przesunięte w stosunku do UTC, przesunięcie jest ujemne. Na przykład utc_offset to -60 dla Wysp Zielonego Przylądka. Dostępne tylko w PlacesService.getDetails.
utc_offset_minutes optional
Typ:  number optional
Odchylenie bieżącej strefy czasowej Miejsca od czasu UTC w minutach. Na przykład w Sydney w Australii w czasie letnim jest 11 godzin więcej niż w UTC, więc utc_offset_minutes będzie 660. W przypadku stref czasowych opóźnienia UTC przesunięcie jest ujemne. Na przykład utc_offset_minutes to -60 w przypadku Republiki Zielonego Przylądka. Dostępna tylko w usłudze PlacesService.getDetails.
vicinity optional
Typ:  string optional
Uproszczony adres Miejsca, w tym nazwa ulicy, numer domu i miejscowość, ale nie województwo, kod pocztowy ani kraj. Na przykład biuro Google w Sydney w Australii ma wartość okolicy "48 Pirrama Road, Pyrmont". Dostępne tylko w PlacesService.getDetails.
website optional
Typ:  string optional
Witryna internetowa powiązana z tym miejscem, np. strona główna firmy. Dostępne tylko w PlacesService.getDetails.

Interfejs PlaceAspectRating

google.maps.places.PlaceAspectRatinginterfejs

Określa informacje o danym aspekcie miejsca, które użytkownicy ocenili w recenzjach.
rating
Typ:  number
Ocena tego aspektu. W przypadku poszczególnych opinii jest to liczba całkowita z zakresu od 0 do 3. W przypadku ocen zbiorczych miejsca jest to liczba całkowita z zakresu 0–30.
type
Typ:  string
Typ aspektu. np. "food", "decor", "service" lub "overall".

stałe BusinessStatus

google.maps.places.BusinessStatus stałe

Stan operacyjny Miejsca, jeśli jest to firma, zwrócony w ramach PlaceResult (wskazuje, czy miejsce jest czynne, czy jest tymczasowo lub na stałe zamknięte). Określ je za pomocą wartości lub nazwy stałej (np. 'OPERATIONAL' lub google.maps.places.BusinessStatus.OPERATIONAL).

Dostęp przez połączenie telefoniczne pod numer const {BusinessStatus} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.
CLOSED_PERMANENTLY Firma została zamknięta na stałe.
CLOSED_TEMPORARILY Firma jest tymczasowo zamknięta.
OPERATIONAL Firma działa normalnie.

Interfejs PlaceGeometry

google.maps.places.PlaceGeometryinterfejs

Definiuje informacje o geometrii miejsca.
location optional
Typ:  LatLng optional
Położenie Miejsca.
viewport optional
Typ:  LatLngBounds optional
Preferowany widoczny obszar podczas wyświetlania tego Miejsca na mapie. Jeśli preferowana wielkość okna przeglądarki dla Miejsca jest nieznana, ta właściwość będzie miała wartość null. Dostępne tylko w PlacesService.getDetails.

Interfejs PlaceOpeningHours

Interfejs google.maps.places.PlaceOpeningHours

Określa informacje o godzinach otwarcia miejsca.
open_now optional
Typ:  boolean optional
Wskazuje, czy to miejsce jest obecnie otwarte.
periods optional
okresy otwarcia obejmujące każdy dzień tygodnia, począwszy od niedzieli, w kolejności chronologicznej; Nie uwzględnia się dni, w których miejsce jest zamknięte. Dostępne tylko w PlacesService.getDetails.
weekday_text optional
Typ:  Array<string> optional
Tablica siedmiu ciągów znaków reprezentujących sformatowane godziny otwarcia w poszczególnych dniach tygodnia. Usługa Miejsca sformatuje i przetłumaczy godziny otwarcia w odpowiednim formacie do wybranego języka. Kolejność elementów w tej tablicy zależy od języka. W niektórych językach tydzień zaczyna się w poniedziałek, a w innych w niedzielę. Dostępna tylko w usłudze PlacesService.getDetails. Inne wywołania mogą zwracać pustą tablicę.
isOpen
isOpen([date])
Parametry: 
  • date:  Date optional
Zwracana wartość:  boolean|undefined
Sprawdź, czy miejsce jest otwarte teraz (jeśli nie podano daty) lub w określonym dniu. Jeśli to miejsce nie ma wartości PlaceResult.utc_offset_minutes ani PlaceOpeningHours.periods, zwracany jest undefined (PlaceOpeningHours.periods jest dostępny tylko przez PlacesService.getDetails). Ta metoda nie uwzględnia wyjątkowych godzin pracy, takich jak godziny otwarcia w święto.

PlaceOpeningHoursPeriod (interfejs)

google.maps.places.PlaceOpeningHoursPeriodinterfejs

Definiuje uporządkowane informacje o godzinach otwarcia miejsca. Uwaga: jeśli Miejsce jest zawsze otwarte, w odpowiedzi nie będzie sekcji close. Klienci mogą mieć pewność, że zawsze otwarte będzie reprezentowane jako okres open zawierający day o wartości 0 i time o wartości "0000", bez close.
open
Godziny otwarcia miejsca.
close optional
Typ:  PlaceOpeningHoursTime optional
Godzina zamknięcia miejsca.

interfejs PlaceOpeningHoursTime

google.maps.places.PlaceOpeningHoursTimeinterfejs

Określa, kiedy miejsce zostanie otwarte lub zamknięte.
day
Typ:  number
Dni tygodnia jako liczba z zakresu [0, 6], począwszy od niedzieli. Na przykład 2 oznacza wtorek.
hours
Typ:  number
Godziny PlaceOpeningHoursTime.time jako liczba z zakresu [0, 23]. Dane te będą podawane w strefie czasowej Miejsca.
minutes
Typ:  number
Liczba minut PlaceOpeningHoursTime.time w zakresie [0, 59]. Będzie ona podana w strefie czasowej miejsca.
time
Typ:  string
Pora dnia w 24-godzinnym formacie „ggmm”. Wartości mieszczą się w zakresie ["0000", "2359"]. Czas będzie podany w strefie czasowej miejsca.
nextDate optional
Typ:  number optional
Sygnatura czasowa (w milisekundach od początku epoki, odpowiednia do użycia z new Date()) reprezentująca następne wystąpienie tego obiektu PlaceOpeningHoursTime. Jest obliczany na podstawie PlaceOpeningHoursTime.day tygodnia, PlaceOpeningHoursTime.time i PlaceResult.utc_offset_minutes. Jeśli PlaceResult.utc_offset_minutes to undefined, wtedy nextDate będzie undefined.

Interfejs PlacePlusCode

Interfejs google.maps.places.PlacePlusCode

Określa kody Open Location Codes lub „Plus Code” dla danego miejsca. Kody Plus Code mogą zastępować adresy ulicy w miejscach, w których ich nie ma (gdzie budynki nie mają numerów, a ulice – nazw).
global_code
Typ:  string
Kod plus z 1/8000 stopnia i 1/8000 stopnia obszaru. Na przykład: "8FVC9G8F+5W".
compound_code optional
Typ:  string optional
Kod plus z 1/8000 stopnia x 1/8000 stopnia obszaru, w którym pierwsze 4 znaki (numer kierunkowy) są pomijane i zastępowane opisem miejscowości. Na przykład: "9G8F+5W Zurich, Switzerland". Jeśli nie uda się znaleźć odpowiedniego rejonu do skrócenia kodu, pomijamy to pole.

Interfejs PlacePhoto

Interfejs google.maps.places.PlacePhoto

Reprezentuje element zdjęcia Miejsca.
height
Typ:  number
Wysokość zdjęcia w pikselach.
html_attributions
Typ:  Array<string>
Tekst informacji o autorze utworu wyświetlany dla tego zdjęcia.
width
Typ:  number
Szerokość zdjęcia w pikselach.
getUrl
getUrl([opts])
Parametry: 
Zwracana wartość:  string
Zwraca adres URL obrazu odpowiadający określonym opcjom.

Interfejs PhotoOptions

Interfejs google.maps.places.PhotoOptions

Określa opcje żądania zdjęć.
maxHeight optional
Typ:  number optional
Maksymalna wysokość zwróconego obrazu w pikselach.
maxWidth optional
Typ:  number optional
Maksymalna szerokość zwróconego obrazu (w pikselach).

Interfejs PlaceReview

google.maps.places.PlaceReviewinterfejs

Oznacza pojedynczą opinię o miejscu.
author_name
Typ:  string
Imię i nazwisko osoby, która przesłała opinię.
language
Typ:  string
Kod języka IETF określający język, w którym została napisana opinia. Pamiętaj, że ten kod zawiera tylko główny tag języka bez dodatkowego tagu wskazującego kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczone tagiem 'en', a nie „en-AU” ani „en-UK”.
profile_photo_url
Typ:  string
Adres URL zdjęcia profilowego wersji.
relative_time_description
Typ:  string
Formatowany ciąg znaków zawierający czas, w którym została napisana opinia, wyrażony w formie odpowiedniej dla języka i kraju. Na przykład "a month ago".
text
Typ:  string
Tekst opinii.
time
Typ:  number
Sygnatura czasowa recenzji wyrażona w sekundach od początku epoki.
aspects optional
Typ:  Array<PlaceAspectRating> optional
Kwestie ocenione w opinii. Oceny w skali od 0 do 3.
author_url optional
Typ:  string optional
Adres URL profilu autora opinii. undefined, gdy profil recenzenta jest niedostępny.
rating optional
Typ:  number optional
Ocena tej recenzji, liczba z zakresu 1,0–5,0 (włącznie).