PlacesService class
google.maps.places.PlacesService
zajęcia
Zawiera metody związane z wyszukiwaniem miejsc i pobieraniem szczegółowych informacji o nich.
Dostęp przez połączenie pod numer const {PlacesService} = await google.maps.importLibrary("places")
.
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
PlacesService |
PlacesService(attrContainer) Parametry:
Tworzy nową instancję PlacesService , która renderuje atrybucje w określonym kontenerze. |
Metody | |
---|---|
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 zostać zwróconych więcej wyników. Wartości PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnej wartości PlaceResult . Aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, wywołując PlacesService.getDetails i przekazując PlaceResult.place_id dla wybranego miejsca. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Parametry:
Zwracana wartość: brak
Pobiera listę miejsc na podstawie ciągu 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 zostać zwróconych więcej wyników. Wartości PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnej wartości PlaceResult . Aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, wywołując PlacesService.getDetails i przekazując PlaceResult.place_id dla wybranego miejsca. |
getDetails |
getDetails(request, callback) Parametry:
Zwracana wartość: brak
Pobiera szczegóły miejsca określonego przez podany identyfikator 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. Lokalizację należy zawsze określać, przekazując parametr LatLngBounds lub parametry location i radius . Obiekty PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnego obiektu PlaceResult . Aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, wysyłając żądanie szczegółów miejsca z PlaceResult.place_id wybranego miejsca. Obiektu PlaceSearchPagination można użyć do pobrania dodatkowych stron wyników (wartość null, jeśli jest to ostatnia strona wyników lub jeśli jest tylko jedna strona wyników). |
textSearch |
textSearch(request, callback) Parametry:
Zwracana wartość: brak
Pobiera listę miejsc na podstawie ciągu zapytania (np. „pizza w Warszawie” lub „sklepy obuwnicze w pobliżu Krakowa”). Parametry lokalizacji są opcjonalne. Jeśli lokalizacja jest określona, wyniki są tylko ukierunkowane na pobliskie wyniki, a nie ograniczone do miejsc w danym obszarze. Użyj textSearch , gdy chcesz wyszukać miejsca za pomocą dowolnego ciągu znaków i w przypadkach, w których nie chcesz ograniczać wyników wyszukiwania do określonej lokalizacji. Obiektu PlaceSearchPagination można użyć do pobrania dodatkowych stron wyników (wartość null, jeśli jest to ostatnia strona wyników lub jeśli jest tylko jedna strona wyników). |
Interfejs PlaceDetailsRequest
google.maps.places.PlaceDetailsRequest
interfejs
Zapytanie o szczegóły miejsca, które ma zostać wysłane do PlacesService
.
Właściwości | |
---|---|
placeId |
Typ:
string Identyfikator miejsca, którego szczegóły są wymagane. |
fields optional |
Typ:
Array<string> optional Pola, które mają być uwzględnione w odpowiedzi ze szczegółami, za które zostanie naliczona opłata. Jeśli nie określisz żadnych pól lub przekażesz wartość ['ALL'] , zwracane będą wszystkie dostępne pola, za które zostanie naliczona opłata (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult . Pola zagnieżdżone można określać za pomocą ścieżek z kropkami (np. "geometry.location" ). |
language optional |
Typ:
string optional Identyfikator języka, w którym mają być zwracane szczegóły. 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 zostaną zwrócone, a także na inne aspekty. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” ( .co.uk ), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”). |
sessionToken optional |
Typ:
AutocompleteSessionToken optional Unikalny identyfikator używany do łączenia prośby o szczegóły z sesją autouzupełniania. |
FindPlaceFromPhoneNumberRequest interfejs
google.maps.places.FindPlaceFromPhoneNumberRequest
interfejs
Prośba o wyszukanie miejsca na podstawie tekstu, która ma zostać wysłana do PlacesService.findPlaceFromPhoneNumber
.
Właściwości | |
---|---|
fields |
Typ:
Array<string> Pola, które mają być uwzględnione w odpowiedzi, za które zostanie naliczona opłata. Jeśli przekażesz wartość ['ALL'] , zwracane będą wszystkie dostępne pola, za które będziesz płacić (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult . Pola zagnieżdżone można określać za pomocą ścieżek z kropkami (np. "geometry.location" ). |
phoneNumber |
Typ:
string Numer telefonu miejsca, które chcesz wyszukać. Musi być w E.164. |
language optional |
Typ:
string optional Identyfikator języka, w którym w miarę możliwości mają być zwracane nazwy i adresy. Zobacz listę obsługiwanych języków. |
locationBias optional |
Typ:
LocationBias optional Odchylenie używane podczas wyszukiwania miejsca. Wynik będzie bardziej zbliżony do podanego LocationBias , ale nie będzie się do niego ograniczać. |
FindPlaceFromQueryRequest interfejs
google.maps.places.FindPlaceFromQueryRequest
interfejs
Prośba o wyszukanie miejsca na podstawie tekstu, która ma zostać wysłana do PlacesService.findPlaceFromQuery
.
Właściwości | |
---|---|
fields |
Typ:
Array<string> Pola, które mają być uwzględnione w odpowiedzi, za które zostanie naliczona opłata. Jeśli przekażesz wartość ['ALL'] , zwracane będą wszystkie dostępne pola, za które będziesz płacić (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult . Pola zagnieżdżone można określać za pomocą ścieżek z kropkami (np. "geometry.location" ). |
query |
Typ:
string Zapytanie w żądaniu. Na przykład nazwa lub adres miejsca. |
language optional |
Typ:
string optional Identyfikator języka, w którym w miarę możliwości mają być zwracane nazwy i adresy. Zobacz listę obsługiwanych języków. |
locationBias optional |
Typ:
LocationBias optional Odchylenie używane podczas wyszukiwania miejsca. Wynik będzie bardziej zbliżony do podanego LocationBias , ale nie będzie się do niego ograniczać. |
PlaceSearchRequest interfejs
google.maps.places.PlaceSearchRequest
interfejs
Zapytanie dotyczące wyszukiwania miejsca, które ma zostać wysłane do PlacesService
.
Właściwości | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional Granice, w których mają być wyszukiwane miejsca. Jeśli ustawiona jest wartość bounds , zarówno location , jak i radius są ignorowane. |
keyword optional |
Typ:
string optional Termin, który ma być dopasowany do wszystkich dostępnych pól, w tym m.in. nazwy, typu i adresu, a także opinii klientów i innych treści pochodzących od osób trzecich. |
language optional |
Typ:
string optional Identyfikator języka, w którym w miarę możliwości mają być zwracane nazwy i adresy. 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 poziomie cenowym lub niższym. Prawidłowe wartości to od 0 (najbardziej przystępna cena) do 4 (najwyższa cena) włącznie. Jeśli została określona, musi być równa lub większa niż minPrice . |
minPriceLevel optional |
Typ:
number optional Ogranicza wyniki tylko do miejsc o określonym poziomie cen lub wyższym. Prawidłowe wartości to od 0 (najbardziej przystępna cena) do 4 (najwyższa cena) włącznie. Jeśli wartość została określona, musi być równa lub mniejsza niż maxPrice . |
|
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 miejsc, które są obecnie otwarte. |
radius optional |
Typ:
number optional Odległość od podanej lokalizacji, w której mają być wyszukiwane miejsca (w metrach). Maksymalna dozwolona wartość to 50 000. |
rankBy optional |
Typ:
RankBy optional Domyślnie:
RankBy.PROMINENCE Określa metodę rankingu, która ma być używana podczas zwracania wyników. Pamiętaj, że gdy parametr rankBy ma wartość DISTANCE , musisz określić parametr location , ale nie możesz określić parametrów radius ani bounds . |
type optional |
Typ:
string optional Wyszukuje miejsca danego typu. Typ jest tłumaczony na język lokalny lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli podano też zapytanie, jest ono łączone z ciągiem znaków zlokalizowanego typu. Wyniki innego typu są pomijane w odpowiedzi. Użyj tego pola, aby przeprowadzić wyszukiwanie kategorii niezależne od języka i regionu. Prawidłowe typy znajdziesz tutaj. |
TextSearchRequest interfejs
google.maps.places.TextSearchRequest
interfejs
Prośba o wyszukiwanie tekstowe, która ma zostać wysłana do PlacesService
.
Właściwości | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional Granice używane do określania wyników podczas wyszukiwania miejsc (opcjonalnie). Jeśli ustawiona jest wartość bounds , zarówno location , jak i radius są ignorowane. Wyniki nie będą ograniczone do tych w tych granicach, ale te, które się w nich mieszczą, będą miały wyższą pozycję. |
language optional |
Typ:
string optional Identyfikator języka, w którym w miarę możliwości mają być zwracane nazwy i adresy. Zobacz listę obsługiwanych języków. |
location optional |
Typ:
LatLng|LatLngLiteral optional Środek obszaru używanego do określania preferencji wyników podczas wyszukiwania miejsc. |
query optional |
Typ:
string optional Wyszukiwane hasło w żądaniu. Może to być np. nazwa miejsca („Wieża Eiffla”), kategoria z nazwą lokalizacji („pizza w Nowym Jorku”) lub nazwa miejsca z wyjaśnieniem lokalizacji („Starbucks w Sydney”). |
radius optional |
Typ:
number optional Promień obszaru używanego do określania wyników wyszukiwania miejsc w metrach. |
region optional |
Typ:
string optional Kod regionu, który ma wpływać na wyniki. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” ( .co.uk ), a 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 danego typu. Typ jest tłumaczony na język lokalny lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli podano też zapytanie, jest ono łączone z ciągiem znaków zlokalizowanego typu. Wyniki innego typu są pomijane w odpowiedzi. Użyj tego pola, aby przeprowadzić wyszukiwanie kategorii niezależne od języka i regionu. Prawidłowe typy znajdziesz tutaj. |
RankBy stałe
google.maps.places.RankBy
stałe
Opcje rankingu dla PlaceSearchRequest.
Dostęp przez połączenie pod numer const {RankBy} = await google.maps.importLibrary("places")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
DISTANCE |
Wyniki wyszukiwania miejsc są uporządkowane według odległości od lokalizacji. |
PROMINENCE |
Kolejność wyników wyszukiwania miejsc zależy od ich rozpoznawalności. |
LocationBias typedef
google.maps.places.LocationBias
typedef
Obiekt LocationBias reprezentuje miękką granicę lub wskazówkę, której należy użyć podczas wyszukiwania miejsc. Wyniki mogą pochodzić spoza określonego obszaru. Aby użyć adresu IP bieżącego użytkownika jako wartości odchylenia, możesz podać ciąg znaków "IP_BIAS"
. Uwaga: jeśli używasz Circle
, musisz określić środek i promień.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
typedef
LocationRestriction to ścisła granica używana podczas wyszukiwania miejsc.
Stałe PlacesServiceStatus
google.maps.places.PlacesServiceStatus
stałe
Stan zwracany przez PlacesService
po zakończeniu wyszukiwania. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK'
lub google.maps.places.PlacesServiceStatus.OK
.
Dostęp przez połączenie pod numer const {PlacesServiceStatus} = await google.maps.importLibrary("places")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
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 ma uprawnień do korzystania z PlacesService . |
UNKNOWN_ERROR |
Nie udało się zrealizować żądania PlacesService z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się powieść. |
ZERO_RESULTS |
Nie znaleziono wyników dla tego żądania. |
PlaceSearchPagination interfejs
google.maps.places.PlaceSearchPagination
interfejs
Obiekt służący do pobierania dodatkowych stron wyników Miejsc.
Właściwości | |
---|---|
hasNextPage |
Typ:
boolean Wskazuje, czy dostępne są dalsze wyniki. true gdy jest dostępna dodatkowa strona wyników. |
Metody | |
---|---|
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. |
PlaceResult interfejs
google.maps.places.PlaceResult
interfejs
Definiuje informacje o miejscu.
Właściwości | |
---|---|
address_components optional |
Typ:
Array<GeocoderAddressComponent> optional Zbiór komponentów adresu lokalizacji tego miejsca. Dostępne tylko w przypadku PlacesService.getDetails . |
adr_address optional |
Typ:
string optional Reprezentacja adresu miejsca w mikroformacie adr. Dostępne tylko w przypadku PlacesService.getDetails . |
aspects optional |
Typ:
Array<PlaceAspectRating> optional Ocenione aspekty 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 jest otwarte, czy zamknięte tymczasowo lub na stałe). Jeśli dane nie są dostępne, flaga nie jest widoczna w odpowiedziach na wyszukiwanie ani w odpowiedziach zawierających szczegółowe informacje. |
formatted_address optional |
Typ:
string optional Pełny adres miejsca. |
formatted_phone_number optional |
Typ:
string optional Numer telefonu miejsca sformatowany zgodnie z konwencją regionalną. Dostępne tylko w przypadku PlacesService.getDetails . |
geometry optional |
Typ:
PlaceGeometry optional Informacje o geometrii miejsca. |
html_attributions optional |
Typ:
Array<string> optional Tekst atrybucji, który ma być wyświetlany w przypadku tego wyniku dotyczącego miejsca. Dostępne html_attributions są zawsze zwracane niezależnie od tego, o jakie fields poproszono, i muszą być wyświetlane. |
icon optional |
Typ:
string optional Adres URL zasobu obrazu, który może reprezentować kategorię 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 można uzyskać, 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 przypadku PlacesService.getDetails . |
name optional |
Typ:
string optional Nazwa miejsca. Uwaga: w przypadku miejsc wpisanych przez użytkownika jest to tekst w formie, w jakiej został wpisany. Zachowaj ostrożność podczas korzystania z tych danych, ponieważ złośliwi użytkownicy mogą próbować wykorzystać je jako wektor ataków polegających na wstrzykiwaniu kodu (patrz http://en.wikipedia.org/wiki/Code_injection). |
opening_hours optional |
Typ:
PlaceOpeningHours optional Określa, kiedy miejsce jest otwarte lub zamknięte. |
|
Typ:
boolean optional Flaga wskazująca, czy miejsce jest zamknięte na stałe lub tymczasowo. Jeśli miejsce jest otwarte lub nie są dostępne żadne dane, flaga nie jest uwzględniana w odpowiedzi. |
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 otwartej lokalizacji lub „kody plus” dla miejsca. |
price_level optional |
Typ:
number optional Poziom cen w miejscu w skali od 0 do 4. Poziomy cen są interpretowane w ten sposób:
|
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 przypadku PlacesService.getDetails . |
types optional |
Typ:
Array<string> optional |
url optional |
Typ:
string optional Adres URL oficjalnej strony Google tego miejsca. Jest to strona należąca do Google, która zawiera najlepsze dostępne informacje o miejscu. Dostępne tylko w przypadku PlacesService.getDetails . |
user_ratings_total optional |
Typ:
number optional Liczba ocen użytkowników, które wpłynęły na PlaceResult.rating tego miejsca. |
|
Typ:
number optional Przesunięcie od czasu UTC bieżącej strefy czasowej miejsca w minutach. Na przykład w Sydney w Australii w okresie obowiązywania czasu letniego jest 11 godzin przed UTC, więc utc_offset będzie wynosić 660 . W przypadku stref czasowych, w których jest wcześniej niż w UTC, przesunięcie jest ujemne. Na przykład utc_offset to -60 w przypadku Republiki Zielonego Przylądka. Dostępne tylko w przypadku PlacesService.getDetails . |
utc_offset_minutes optional |
Typ:
number optional Przesunięcie od czasu UTC bieżącej strefy czasowej miejsca w minutach. Na przykład w Sydney w Australii w okresie obowiązywania czasu letniego jest 11 godzin przed UTC, więc utc_offset_minutes będzie wynosić 660 . W przypadku stref czasowych, w których jest wcześniej niż w UTC, przesunięcie jest ujemne. Na przykład utc_offset_minutes to -60 w przypadku Republiki Zielonego Przylądka. Dostępne tylko w przypadku PlacesService.getDetails . |
vicinity optional |
Typ:
string optional Uproszczony adres miejsca, który zawiera nazwę ulicy, numer domu i miejscowość, ale nie zawiera województwa/stanu, kodu pocztowego ani kraju. Na przykład biuro Google w Sydney w Australii ma wartość bliskości "48 Pirrama Road, Pyrmont" . Dostępne tylko w przypadku PlacesService.getDetails . |
website optional |
Typ:
string optional Autorytatywna witryna tego miejsca, np. strona główna firmy. Dostępne tylko w przypadku PlacesService.getDetails . |
PlaceAspectRating interfejs
google.maps.places.PlaceAspectRating
interfejs
Określa informacje o aspekcie miejsca, który został oceniony przez użytkowników.
Właściwości | |
---|---|
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 od 0 do 30. |
type |
Typ:
string Typ aspektu. Na przykład "food" , "decor" , "service" lub "overall" . |
Stałe wartości BusinessStatus
google.maps.places.BusinessStatus
stałe
Stan działalności miejsca, jeśli jest to firma, zwrócony w obiekcie PlaceResult (wskazuje, czy miejsce jest czynne, czy zamknięte tymczasowo lub na stałe). Określ je za pomocą wartości lub nazwy stałej (np. 'OPERATIONAL'
lub google.maps.places.BusinessStatus.OPERATIONAL
).
Dostęp przez połączenie pod numer const {BusinessStatus} = await google.maps.importLibrary("places")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
CLOSED_PERMANENTLY |
Firma jest zamknięta na stałe. |
CLOSED_TEMPORARILY |
Firma jest tymczasowo zamknięta. |
OPERATIONAL |
Firma działa normalnie. |
PlaceGeometry interfejs
google.maps.places.PlaceGeometry
interfejs
Określa informacje o geometrii miejsca.
Właściwości | |
---|---|
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 widok miejsca jest nieznany, ta właściwość będzie miała wartość null . Dostępne tylko w przypadku PlacesService.getDetails . |
PlaceOpeningHours interfejs
google.maps.places.PlaceOpeningHours
interfejs
Określa informacje o godzinach otwarcia miejsca.
Właściwości | |
---|---|
|
Typ:
boolean optional Określa, czy miejsce jest otwarte w danym momencie. |
periods optional |
Typ:
Array<PlaceOpeningHoursPeriod> optional Okresy otwarcia dla każdego dnia tygodnia, począwszy od niedzieli, w kolejności chronologicznej. Dni, w których miejsce jest zamknięte, nie są uwzględniane. Dostępne tylko w przypadku PlacesService.getDetails . |
weekday_text optional |
Typ:
Array<string> optional Tablica 7 ciągów znaków reprezentujących sformatowane godziny otwarcia w poszczególnych dniach tygodnia. Usługa Miejsca sformatuje i zlokalizuje godziny otwarcia odpowiednio do bieżącego 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ępne tylko w przypadku PlacesService.getDetails . Inne wywołania mogą zwracać pustą tablicę. |
Metody | |
---|---|
isOpen |
isOpen([date]) Parametry:
Zwracana wartość:
boolean|undefined Sprawdź, czy miejsce jest otwarte teraz (gdy nie podano daty) lub w podanym dniu. Jeśli miejsce nie ma wartości PlaceResult.utc_offset_minutes ani PlaceOpeningHours.periods , zwracana jest wartość undefined (wartość PlaceOpeningHours.periods jest dostępna tylko w ramach PlacesService.getDetails ). Ta metoda nie uwzględnia godzin wyjątkowych, np. godzin otwarcia w święta. |
PlaceOpeningHoursPeriod interfejs
google.maps.places.PlaceOpeningHoursPeriod
interfejs
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 open
okres zawierający day
z wartością 0
i time
z wartością "0000"
, a nie close
.
Właściwości | |
---|---|
open |
Godzina otwarcia miejsca. |
close optional |
Typ:
PlaceOpeningHoursTime optional Godzina zamknięcia miejsca. |
PlaceOpeningHoursTime interfejs
google.maps.places.PlaceOpeningHoursTime
interfejs
Określa, kiedy miejsce jest otwarte lub zamknięte.
Właściwości | |
---|---|
day |
Typ:
number Dni tygodnia jako liczby z zakresu [ 0 , 6 ], przy czym niedziela jest pierwszym dniem tygodnia. Na przykład 2 oznacza wtorek. |
hours |
Typ:
number Godziny PlaceOpeningHoursTime.time jako liczba z zakresu [0 , 23 ]. Będą one podawane w strefie czasowej miejsca. |
minutes |
Typ:
number Minuty godziny PlaceOpeningHoursTime.time jako liczba z zakresu [0 , 59 ]. Będzie to podawane w strefie czasowej miejsca. |
time |
Typ:
string Godzina w formacie 24-godzinnym „ggmm”. Wartości mieszczą się w zakresie [ "0000" , "2359" ]. Czas będzie podawany 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. Oblicza się go na podstawie PlaceOpeningHoursTime.day tygodnia, PlaceOpeningHoursTime.time i PlaceResult.utc_offset_minutes . Jeśli PlaceResult.utc_offset_minutes to undefined , wtedy nextDate będzie mieć wartość undefined . |
PlacePlusCode interfejs
google.maps.places.PlacePlusCode
interfejs
Określa kody otwartej lokalizacji lub „kody plus” dla miejsca. Kody Plus Code mogą zastępować adresy w miejscach, w których nie istnieją (gdzie budynki nie mają numerów lub ulice nie mają nazw).
Właściwości | |
---|---|
global_code |
Typ:
string Kod plus obejmujący obszar o wymiarach 1/8000 stopnia na 1/8000 stopnia. Na przykład: "8FVC9G8F+5W" . |
compound_code optional |
Typ:
string optional Kod plus o obszarze 1/8000 stopnia na 1/8000 stopnia, w którym pierwsze 4 znaki (kod obszaru) są pomijane i zastępowane opisem miejscowości. Na przykład: "9G8F+5W Zurich, Switzerland" . Jeśli nie można znaleźć odpowiedniej miejscowości, aby skrócić kod, to pole jest pomijane. |
PlacePhoto interfejs
google.maps.places.PlacePhoto
interfejs
Reprezentuje element zdjęcia miejsca.
Właściwości | |
---|---|
height |
Typ:
number Wysokość zdjęcia w pikselach. |
html_attributions |
Typ:
Array<string> Tekst źródła, który ma być wyświetlany w przypadku tego zdjęcia. |
width |
Typ:
number Szerokość zdjęcia w pikselach. |
Metody | |
---|---|
getUrl |
getUrl([opts]) Parametry:
Zwracana wartość:
string Zwraca adres URL obrazu odpowiadający określonym opcjom. |
PhotoOptions interfejs
google.maps.places.PhotoOptions
interfejs
Określa opcje żądania zdjęć.
Właściwości | |
---|---|
maxHeight optional |
Typ:
number optional Maksymalna wysokość zwracanego obrazu w pikselach. |
maxWidth optional |
Typ:
number optional Maksymalna szerokość zwracanego obrazu w pikselach. |
PlaceReview interfejs
google.maps.places.PlaceReview
interfejs
Reprezentuje pojedynczą opinię o miejscu.
Właściwości | |
---|---|
author_name |
Typ:
string Imię i nazwisko autora opinii. |
language |
Typ:
string Kod języka IETF wskazujący język, w którym napisana jest ta opinia. Pamiętaj, że ten kod zawiera tylko główny tag języka bez żadnego tagu dodatkowego wskazującego kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczane jako 'en' , a nie „en-AU” czy „en-UK”. |
profile_photo_url |
Typ:
string Adres URL zdjęcia profilowego recenzenta. |
relative_time_description |
Typ:
string Ciąg znaków sformatowanego niedawnego czasu, wyrażający czas opinii w stosunku do bieżącego czasu w formie odpowiedniej dla języka i kraju. Na przykład "a month ago" . |
text |
Typ:
string Tekst opinii. |
time |
Typ:
number Sygnatura czasowa opinii wyrażona w sekundach od początku epoki. |
|
Typ:
Array<PlaceAspectRating> optional Aspekty ocenione w opinii. Oceny w skali od 0 do 3. |
author_url optional |
Typ:
string optional Adres URL profilu osoby oceniającej. Gdy profil recenzenta jest niedostępny, będzie to undefined . |
rating optional |
Typ:
number optional Ocena tej opinii, liczba z przedziału od 1,0 do 5,0 (włącznie). |