Places Service

Klasa PlacesService

Klasa google.maps.places.PlacesService

Zawiera metody dotyczące wyszukiwania miejsc i pobierania informacji o tym miejscu.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

PlacesService
PlacesService(attrContainer)
Parametry:
Tworzy nowe wystąpienie elementu PlacesService, które renderuje atrybucję w określonym kontenerze.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parametry:
Wartość zwrotu: brak
Pobiera listę miejsc na podstawie numeru telefonu. W większości przypadków na liście wyników powinien być tylko 1 element, ale jeśli żądanie jest niejednoznaczne, może zostać zwrócony więcej niż 1 wynik. Właściwości PlaceResult przekazywane do wywołania zwrotnego to podzbiory pełnego elementu PlaceResult. Aby uzyskać bardziej szczegółowe informacje o PlaceResult aplikacji dla każdego miejsca, możesz zadzwonić pod numer PlacesService.getDetails i przekazać PlaceResult.place_id odpowiednie miejsce.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parametry:
Wartość zwrotu: brak
Pobiera listę miejsc na podstawie ciągu zapytania. W większości przypadków na liście wyników powinien być tylko 1 element, ale jeśli żądanie jest niejednoznaczne, może zostać zwrócony więcej niż 1 wynik. Właściwości PlaceResult przekazywane do wywołania zwrotnego to podzbiory pełnego elementu PlaceResult. Aby uzyskać bardziej szczegółowe informacje o PlaceResult aplikacji dla każdego miejsca, możesz zadzwonić pod numer PlacesService.getDetails i przekazać PlaceResult.place_id odpowiednie miejsce.
getDetails
getDetails(request, callback)
Parametry:
Wartość zwrotu: brak
Pobiera szczegółowe informacje o miejscu identyfikowanym przez właściwość placeId.
nearbySearch
nearbySearch(request, callback)
Parametry:
Wartość zwrotu: brak
Pobiera listę miejsc w pobliżu konkretnej lokalizacji na podstawie słów kluczowych lub typów. Aby określić lokalizację, musisz podać parametr LatLngBounds lub location i radius. Właściwości PlaceResult przekazywane do wywołania zwrotnego to podzbiory pełnego elementu PlaceResult. Aby uzyskać bardziej szczegółowe PlaceResult informacje o każdym miejscu, możesz wysłać żądanie szczegółów miejsca, które przekazuje PlaceResult.place_id odpowiednie miejsce. Obiekt PlaceSearchPagination może służyć do pobierania dodatkowych stron wyników (pusto, jeśli jest to ostatnia strona wyników lub jeśli występuje tylko jedna strona wyników).
textSearch
textSearch(request, callback)
Parametry:
Wartość zwrotu: brak
Pobiera listę miejsc na podstawie ciągu zapytania (np. „"pizza” w Gdańsku lub w sklepie „buty w pobliżu Warszawy”). Parametry lokalizacji są opcjonalne. Jeśli podasz lokalizację, wyniki będą wyświetlane tylko w pobliżu wyników, a nie tylko w tych miejscach na miejscu. Użyj textSearch, gdy chcesz wyszukać miejsca za pomocą dowolnego ciągu znaków oraz w sytuacji, gdy nie chcesz ograniczać wyników wyszukiwania do określonej lokalizacji. Obiekt PlaceSearchPagination może służyć do pobierania dodatkowych stron wyników (pusto, jeśli jest to ostatnia strona wyników lub jeśli występuje tylko jedna strona wyników).

Interfejs PlaceDetailsRequest

google.maps.places.PlaceDetailsRequest interfejs

Zapytanie o szczegóły miejsca zostanie wysłane na adres PlacesService.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

placeId
Typ: string
Identyfikator miejsca, którego dotyczy prośba.
fields optional
Typ: Array<string> optional
Pola, które zostaną uwzględnione w odpowiedzi na pytanie o szczegóły i za którą będą naliczane opłaty. Jeśli nie określisz żadnej wartości lub nie zostanie przekazane pole ['ALL'], wszystkie dostępne pola zostaną zwrócone i rozliczane (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz w sekcji PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek z kropkami (np. "geometry.location").
language optional
Typ: string optional
Identyfikator języka, w którym należy wyświetlić szczegóły. Zobacz listę obsługiwanych języków.
region optional
Typ: string optional
Kod regionu regionu użytkownika. Może to wpłynąć na to, które zdjęcia mogą zostać zwrócone, a także na inne rzeczy. Kod regionu może mieć wartość dwuznakową ccTLD ("domena najwyższego poziomu"). Większość kodów ccTLD jest taka sama jak kody ISO 3166-1, ale istnieją pewne wyjątki. Na przykład Wielka Brytania to „"uk" (.co.uk), a jej kod ISO 3166-1 to „"gb"” (technicznie rzecz biorąc, m.in. w Wielkiej Brytanii i Irlandii Północnej).
sessionToken optional
Unikalne odwołanie używane do łączenia żądania szczegółów z sesją autouzupełniania.

FindPlaceFromPhoneNumberRequest interfejs

google.maps.places.FindPlaceFromPhoneNumberRequest interfejs

Znajdź miejsce z zapytania tekstowego, które ma zostać wysłane na adres PlacesService.findPlaceFromPhoneNumber.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

fields
Typ: Array<string>
Pola, które zostaną uwzględnione w odpowiedzi i opłaty za nią. Jeśli właściwość ['ALL'] zostanie przekazana, wszystkie dostępne pola zostaną zwrócone i rozliczone (niezalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz w sekcji PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek z kropkami (np. "geometry.location").
phoneNumber
Typ: string
Numer telefonu danego miejsca do wyszukiwania. Musi to być format E.164.
language optional
Typ: string optional
Identyfikator języka, w którym powinny być zwracane nazwy i adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków.
locationBias optional
Typ: LocationBias optional
odchylenie używane podczas wyszukiwania miejsca. Wyniki będą dyskryminowane między innymi w przypadku podanego LocationBias.

FindPlaceFromQueryRequest Interfejs

google.maps.places.FindPlaceFromQueryRequest interfejs

Znajdź miejsce z zapytania tekstowego, które ma zostać wysłane na adres PlacesService.findPlaceFromQuery.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

fields
Typ: Array<string>
Pola, które zostaną uwzględnione w odpowiedzi i opłaty za nią. Jeśli właściwość ['ALL'] zostanie przekazana, wszystkie dostępne pola zostaną zwrócone i rozliczone (niezalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz w sekcji PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek z kropkami (np. "geometry.location").
query
Typ: string
Zapytanie. Może to być na przykład nazwa lub adres miejsca.
language optional
Typ: string optional
Identyfikator języka, w którym powinny być zwracane nazwy i adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków.
locationBias optional
Typ: LocationBias optional
odchylenie używane podczas wyszukiwania miejsca. Wyniki będą dyskryminowane między innymi w przypadku podanego LocationBias.

PlaceSearchRequest interfejs

google.maps.places.PlaceSearchRequest interfejs

Zapytanie dotyczące miejsca do wysłania na adres PlacesService.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

bounds optional
Granice miejsc, w których można wyszukiwać miejsca. Zarówno ustawienie location, jak i radius zostaną zignorowane, jeśli ustawisz bounds.
keyword optional
Typ: string optional
Hasło dopasowane do wszystkich dostępnych pól, w tym m.in. nazwy, typu i adresu, a także opinii klientów i innych treści należących do osób trzecich.
language optional
Typ: string optional
Identyfikator języka, w którym powinny 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 której można wyszukać miejsca.
maxPriceLevel optional
Typ: number optional
Ogranicza wyniki tylko do tych miejsc na określonym poziomie cen lub niższym. Akceptowane są wartości z zakresu od 0 (najtańszy) do 4 (najdroższy). Wartość musi być większa niż lub równa minPrice (jeśli została określona).
minPriceLevel optional
Typ: number optional
Ogranicza wyniki tylko do tych miejsc w określonej cenie lub wyższej. Akceptowane są wartości z zakresu od 0 (najtańszy) do 4 (najdroższy). Wartość nie może być większa 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 ciągu wyszukiwania.
openNow optional
Typ: boolean optional
Ogranicza wyniki tylko do tych miejsc, które są w tej chwili otwarte.
radius optional
Typ: number optional
Odległość od podanej lokalizacji, w której można wyszukiwać miejsca, w metrach. Maksymalna dozwolona wartość to 50 000.
rankBy optional
Typ: RankBy optional
Wartość domyślna: RankBy.PROMINENCE
Określa metodę rankingu, która ma być użyta podczas zwracania wyników. Pamiętaj, że gdy rankBy ma wartość DISTANCE, musisz podać location, ale nie możesz określić radius ani bounds.
type optional
Typ: string optional
Wyszukiwanie miejsc określonego typu. Typ jest tłumaczony na lokalny język lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli zapytanie zostanie również wykonane, zostanie połączone ze zlokalizowanym ciągiem znaków. Wyniki innego typu są usuwane z odpowiedzi. Tego pola możesz użyć, aby wyszukiwać informacje w różnych kategoriach niezależnie od języka i regionu. Prawidłowe typy znajdziesz tutaj.

TextSearchRequest interfejs

google.maps.places.TextSearchRequest interfejs

Żądanie wyszukiwania tekstowego do wysłania na adres PlacesService.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

bounds optional
Ograniczenia używane do odchylenia wyników podczas wyszukiwania miejsc (opcjonalnie). Zarówno ustawienie location, jak i radius zostaną zignorowane, jeśli ustawisz bounds. Wyniki nie będą ograniczone do osób znajdujących się w tych granicach, ale znajdujące się w nich wyniki będą miały wyższą pozycję w rankingu.
language optional
Typ: string optional
Identyfikator języka, w którym powinny 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 do odchylenia wyników podczas wyszukiwania miejsc.
query optional
Typ: string optional
Zapytanie w żądaniu. Mogą to być na przykład nazwa miejsca ('wieża Eiffla&#99); kategoria, po której następuje nazwa lokalizacji ('pizza w Warszawie);
radius optional
Typ: number optional
Promień obszaru używanego do odchylenia wyników podczas wyszukiwania miejsc w metrach.
region optional
Typ: string optional
Kod regionu, który ma powodować odchylenie wyników. Kod regionu może mieć wartość dwuznakową ccTLD ("domena najwyższego poziomu"). Większość kodów ccTLD jest taka sama jak kody ISO 3166-1, ale istnieją pewne wyjątki. Na przykład Wielka Brytania to „"uk" (.co.uk), a jej kod ISO 3166-1 to „"gb"” (technicznie rzecz biorąc, m.in. w Wielkiej Brytanii i Irlandii Północnej).
type optional
Typ: string optional
Wyszukiwanie miejsc określonego typu. Typ jest tłumaczony na lokalny język lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli zapytanie zostanie również wykonane, zostanie połączone ze zlokalizowanym ciągiem znaków. Wyniki innego typu są usuwane z odpowiedzi. Tego pola możesz użyć, aby wyszukiwać informacje w różnych kategoriach niezależnie od języka i regionu. Prawidłowe typy znajdziesz tutaj.

RankBy – stałe

google.maps.places.RankBy stałe

Opcje rankingu dotyczące PlaceSearchRequest.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

DISTANCE Ranking miejsc wyników według odległości od lokalizacji.
PROMINENCE Ranking wyników wyszukiwania ustala się na podstawie ich widoczności.

LocationBias typ

google.maps.places.LocationBias typ

LocationBias to miękka granica lub wskazówka używana podczas wyszukiwania miejsc. Wyniki mogą pochodzić spoza określonego obszaru. Aby użyć adresu IP bieżącego użytkownika jako odchylenia, można określić ciąg "IP_BIAS". Uwaga: jeśli używasz właściwości Circle, musisz określić środek i promień.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

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

Typ ograniczenia lokalizacji

google.maps.places.LocationRestriction typ

Ograniczenie lokalizacji określa ścisłą granicę używaną podczas wyszukiwania miejsc.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

LatLngBounds|LatLngBoundsLiteral

Stałe PlacesServiceStatus

google.maps.places.PlacesServiceStatus stałe

Stan zwrócony przez zasadę PlacesService po zakończeniu wyszukiwania. Możesz określić je, podając wartość lub używając nazwy stałej. na przykład 'OK' lub google.maps.places.PlacesServiceStatus.OK.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

INVALID_REQUEST To żądanie było nieprawidłowe.
NOT_FOUND Nie znaleziono wskazanego miejsca.
OK Odpowiedź zawiera prawidłowy wynik.
OVER_QUERY_LIMIT Aplikacja przekroczyła limit żądań.
REQUEST_DENIED Aplikacja nie może używać PlacesService.
UNKNOWN_ERROR Nie udało się przetworzyć żądania PlacesService z powodu błędu serwera. Żądanie może się udać, jeśli spróbujesz ponownie.
ZERO_RESULTS Nie znaleziono wyników dla tego żądania.

PlaceSearchPagination interfejs

google.maps.places.PlaceSearchPagination interfejs

Obiekt używany do pobierania dodatkowych stron wyników wyszukiwania miejsc.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

hasNextPage
Typ: boolean
Wskazuje, czy są dostępne dalsze wyniki. true, gdy dostępna jest dodatkowa strona wyników.
nextPage
nextPage()
Parametry: brak
Wartość zwrotu: brak
Pobiera następną stronę wyników. Korzysta z tej samej funkcji wywołania zwrotnego, która została podana w pierwszym żądaniu wyszukiwania.

PlaceResult interfejs

google.maps.places.PlaceResult interfejs

Określa miejsce.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

address_components optional
Zestaw komponentów adresu dla lokalizacji tego miejsca. Dostępne tylko w aplikacji PlacesService.getDetails.
adr_address optional
Typ: string optional
Sposób wyświetlania adresu miejsca w mikroformacie DR. Dostępne tylko w aplikacji PlacesService.getDetails.
aspects optional
Typ: Array<PlaceAspectRating> optional
Ocena tego miejsca na podstawie opinii użytkowników Google i Zagat. Oceny są podawane w skali od 0 do 30.
business_status optional
Typ: BusinessStatus optional
Flaga wskazująca stan operacyjny miejsca, jeśli jest to firma (wskazuje, czy miejsce działa, czy zostało zamknięte tymczasowo lub na stałe). Jeśli żadne dane nie są dostępne, flaga nie jest widoczna w wynikach wyszukiwania ani w szczegółach odpowiedzi.
formatted_address optional
Typ: string optional
Pełny adres miejsca.
formatted_phone_number optional
Typ: string optional
Numer telefonu miejsca zgodnie z konwencją regionalną. Dostępne tylko w aplikacji PlacesService.getDetails.
geometry optional
Typ: PlaceGeometry optional
informacje geometryczne dotyczące miejsca;
html_attributions optional
Typ: Array<string> optional
Tekst atrybucji, który będzie wyświetlany w przypadku tego wyniku miejsca. Dostępne wartości html_attributions są zawsze zwracane niezależnie od tego, o co prosiono fields i muszą być wyświetlane.
icon optional
Typ: string optional
Adres URL zasobu graficznego, którego można użyć do reprezentowania kategorii tego miejsca.
icon_background_color optional
Typ: string optional
Kolor tła używany z ikoną miejsca. Zobacz też PlaceResult.icon_mask_base_uri.
icon_mask_base_uri optional
Typ: string optional
Skrócony URL do maski ikony. Aby uzyskać dostęp do różnych typów ikon, dołącz 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 aplikacji PlacesService.getDetails.
name optional
Typ: string optional
Nazwa miejsca. Uwaga: jeśli użytkownik wpisał Miejsca, jest to nieprzetworzony tekst wpisany przez użytkownika. Zachowaj ostrożność, korzystając z tych danych, ponieważ szkodliwi użytkownicy mogą ich używać jako narzędzia do ataków wstrzykiwanych kodu (więcej informacji: 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 pokazująca, że miejsce jest zamknięte na stałe lub tymczasowo. Jeśli miejsce działa lub jeśli nie ma dostępnych danych, w odpowiedzi brakuje flagi.
photos optional
Typ: Array<PlacePhoto> optional
Zdjęcia tego miejsca. Kolekcja będzie zawierać do 10 obiektów PlacePhoto.
place_id optional
Typ: string optional
Niepowtarzalny identyfikator miejsca.
plus_code optional
Typ: PlacePlusCode optional
Określa otwarte kody lokalizacji lub kody Plus Code.
price_level optional
Typ: number optional
Poziom cenowy miejsca w skali od 0 do 4. Poziomy cenowe są interpretowane w następujący sposób:
  • 0: bezpłatnie
  • 1: niedrogo
  • 2: umiarkowany
  • 3: drogo
  • 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 aplikacji PlacesService.getDetails.
types optional
Typ: Array<string> optional
Tablica typów tego miejsca (np. ["political", "locality"] lub ["restaurant", "establishment"]).
url optional
Typ: string optional
Adres URL oficjalnej strony Google dla tego miejsca. To jest strona Google, która zawiera najlepsze dostępne informacje o tym miejscu. Dostępne tylko w aplikacji PlacesService.getDetails.
user_ratings_total optional
Typ: number optional
Liczba ocen użytkowników, które zostały dodane do PlaceResult.rating tego miejsca.
utc_offset optional
Typ: number optional
Przesunięcie w stosunku do czasu UTC bieżącej strefy czasowej miejsca (w minutach). Na przykład czas letni w Australii wynosi 11 godzin w stosunku do czasu UTC, więc utc_offset będzie wynosić 660. W strefach czasowych, w których obowiązuje czas UTC, przesunięcie jest ujemne. Na przykład utc_offset to -60 dla Republiki Zielonego Przylądka. Dostępne tylko w aplikacji PlacesService.getDetails.
utc_offset_minutes optional
Typ: number optional
Przesunięcie w stosunku do czasu UTC bieżącej strefy czasowej miejsca (w minutach). Na przykład czas letni w Australii wynosi 11 godzin w stosunku do czasu UTC, więc utc_offset_minutes będzie wynosić 660. W strefach czasowych, w których obowiązuje czas UTC, przesunięcie jest ujemne. Na przykład utc_offset_minutes to -60 dla Republiki Zielonego Przylądka. Dostępne tylko w aplikacji PlacesService.getDetails.
vicinity optional
Typ: string optional
Uproszczony adres miejsca, w tym nazwa ulicy, numer domu i miejscowość, ale nie prowincja/stan, kod pocztowy ani kraj. Na przykład biuro Google w Australii ma wartość "48 Pirrama Road, Pyrmont" w okolicy. Dostępne tylko w aplikacji PlacesService.getDetails.
website optional
Typ: string optional
Wiarygodna strona tego miejsca, np. strona główna firmy. Dostępne tylko w aplikacji PlacesService.getDetails.

PlaceAspectRating interfejs

google.maps.places.PlaceAspectRating interfejs

Określa informacje o miejscu, które oceniają użytkownicy.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

rating
Typ: number
Ocena tego aspektu. W przypadku poszczególnych opinii jest to liczba całkowita z zakresu od 0 do 3. W przypadku zbiorczych ocen miejsca jest to liczba całkowita z zakresu od 0 do 30.
type
Typ: string
Typ obrazu. na przykład "food", "decor", "service" lub "overall".

Statusy biznesowe

google.maps.places.BusinessStatus stałe

Stan operacyjny miejsca, jeśli jest to firma, zwrócony w miejsce PlaceResult (wskazuje, czy miejsce działa, czy zostało zamknięte tymczasowo lub na stałe). Określ je według wartości lub nazwy stałej (na przykład 'OPERATIONAL' lub google.maps.places.BusinessStatus.OPERATIONAL).

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

CLOSED_PERMANENTLY Firma jest zamknięta na stałe.
CLOSED_TEMPORARILY Firma jest tymczasowo zamknięta.
OPERATIONAL Firma działa normalnie.

Interfejs Place Geometry

google.maps.places.PlaceGeometry interfejs

Określa informacje o geometrii miejsca.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

location optional
Typ: LatLng optional
pozycja miejsca.
viewport optional
Typ: LatLngBounds optional
Preferowany widoczny obszar podczas wyświetlania tego miejsca na mapie. Jeśli preferowany widoczny obszar nie jest znany, to null. Dostępne tylko w aplikacji PlacesService.getDetails.

PlaceOpeningHours Interfejs

google.maps.places.PlaceOpeningHours interfejs

Określa godziny otwarcia miejsca.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

open_now optional
Typ: boolean optional
Określa, czy miejsce jest obecnie otwarte.
periods optional
Okresy otwarcia w poszczególnych dniach tygodnia, począwszy od niedzieli, w kolejności chronologicznej. Dni, w których miejsce nie jest otwarte, nie są uwzględniane. Dostępne tylko w aplikacji PlacesService.getDetails.
weekday_text optional
Typ: Array<string> optional
Tablica z 7 ciągami reprezentującymi sformatowane godziny otwarcia w poszczególnych dniach tygodnia. Usługa Miejsca odpowiednio sformatuje i dopasuje godziny otwarcia w bieżącym języku. Kolejność elementów w tej tablicy zależy od języka. Niektóre języki rozpoczynają tydzień w poniedziałek, a w niedzielę. Dostępne tylko w aplikacji PlacesService.getDetails. Inne wywołania mogą zwracać pustą tablicę.
isOpen
isOpen([date])
Parametry:
  • dateDate optional
Wartość zwrotu: boolean|undefined
Sprawdź, czy miejsce jest teraz otwarte (gdy nie minęła data) lub czy w danym dniu. Jeśli dla tego miejsca nie podano PlaceResult.utc_offset_minutes lub PlaceOpeningHours.periods, undefined jest zwracane (PlaceOpeningHours.periods jest dostępne tylko przez PlacesService.getDetails). Ta metoda nie uwzględnia unikalnych godzin, takich jak godziny otwarcia w święto.

PlaceOpeningHoursPeriod interfejs

google.maps.places.PlaceOpeningHoursPeriod interfejs

Określa uporządkowane informacje o godzinach otwarcia miejsca. Uwaga: jeśli miejsce jest zawsze otwarte, w odpowiedzi nie będzie sekcji close. Klienci mogą polegać na tym, że okresy otwartego zawsze są reprezentowane przez okres open zawierający wartość day i time z wartością "0000", a nie close.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

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

PlaceOpeningHoursTime interfejs

google.maps.places.PlaceOpeningHoursTime interfejs

Określa, kiedy miejsce zostanie otwarte lub zamknięte.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

day
Typ: number
Dni tygodnia w postaci liczby w zakresie [0, 6], od niedzieli. Na przykład 2 oznacza wtorek.
hours
Typ: number
Godziny, w których jest wyświetlana wartość PlaceOpeningHoursTime.time w zakresie [0, 23]. Dane będą podawane w strefie czasowej tego miejsca.
minutes
Typ: number
Minuty: PlaceOpeningHoursTime.time jako liczba w zakresie [0, 59]. Zostaną one podane w strefie czasowej tego miejsca.
time
Typ: string
Godzina w formacie 24-godzinnym. Wartości są w zakresie ["0000", "2359"]. Czas będzie raportowany w strefie czasowej tego miejsca.
nextDate optional
Typ: number optional
Sygnatura czasowa (w milisekundach od początku epoki, odpowiednia do użycia z parametrem new Date()) reprezentująca kolejne wystąpienie tego elementu PlaceOpeningHoursTime. Oblicza się go na podstawie wartości PlaceOpeningHoursTime.day tygodnia, PlaceOpeningHoursTime.time i PlaceResult.utc_offset_minutes. Jeśli PlaceResult.utc_offset_minutes to undefined, nextDate będzie mieć wartość undefined.

PlacePlusCode interfejs

google.maps.places.PlacePlusCode interfejs

Określa otwarte kody lokalizacji lub kody Plus Code. Kody Plus Code mogą zastępować adresy ulic w miejscach, w których nie istnieją (gdzie budynki nie mają numerów lub nie mają nazw).

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

global_code
Typ: string
Kod Plus Code: 1/8000 stopnia i 1/8000 dnia obszaru. Na przykład: "8FVC9G8F+5W".
compound_code optional
Typ: string optional
Kod Plus Code z zakresem 1/8000 w skali 1/8000 w obszarze, gdzie pierwsze 4 znaki (numer kierunkowy) są zastępowane i zastąpione opisem miejscowości. Na przykład: "9G8F+5W Zurich, Switzerland". To pole jest pomijane, jeśli nie ma odpowiedniego regionu, który można by skrócić.

PlaceZdjęcie interfejs

google.maps.places.PlacePhoto interfejs

Określa element zdjęcia danego miejsca.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

height
Typ: number
Wysokość zdjęcia w pikselach.
html_attributions
Typ: Array<string>
Tekst atrybucji, który będzie wyświetlany w przypadku tego zdjęcia.
width
Typ: number
Szerokość zdjęcia w pikselach.
getUrl
getUrl([opts])
Parametry:
Wartość zwrotu: string
Zwraca adres URL obrazu odpowiadający określonym opcjom.

PhotoOptions

google.maps.places.PhotoOptions interfejs

Określa opcje żądania zdjęcia.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

maxHeight optional
Typ: number optional
Maksymalna wysokość zwróconego obrazu w pikselach.
maxWidth optional
Typ: number optional
Maksymalna szerokość zwróconego obrazu w pikselach.

PlaceReview

google.maps.places.PlaceReview interfejs

Jest to pojedyncza opinia o miejscu.

Wymaga parametru URL &libraries=places. Zobacz Biblioteki w Maps JavaScript API.

author_name
Typ: string
Imię i nazwisko lub nazwa użytkownika, który dodał opinię.
language
Typ: string
Kod IETF wskazujący język, w którym została napisana opinia. Pamiętaj, że ten kod zawiera tylko tag głównego języka bez dodatkowego tagu wskazującego kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczone etykietą 'en' zamiast „'en-AU&#39”; 'en-UK'.
profile_photo_url
Typ: string
Adres URL zdjęcia profilu odnowienia.
relative_time_description
Typ: string
Ciąg ostatnich sformatowanych ostatnich godzin tak, by wyrażał czas sprawdzenia w sposób dostosowany do języka i kraju. Na przykład: "a month ago".
text
Typ: string
Treść opinii.
time
Typ: number
Sygnatura czasowa opinii wyrażona w sekundach od początku epoki.
aspects optional
Typ: Array<PlaceAspectRating> optional
Aspekty oceniane przez opinię. Oceny w skali od 0 do 3.
author_url optional
Typ: string optional
Adres URL profilu recenzenta. Jeśli profil weryfikatora będzie niedostępny, wyniesie undefined.
rating optional
Typ: number optional
Ocena Twojej opinii o wartości od 1,0 do 5,0 (włącznie).