PlacesService class
google.maps.places.PlacesService
class
Zawiera metody związane z wyszukiwaniem miejsc i pobieraniem informacji o nich.
Dostęp przez połączenie telefoniczne 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 atrybuty 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 zwrócić więcej niż 1 wynik. PlaceResult przekazane do wywołania zwrotnego to podzbiory pełnego PlaceResult . Aplikacja może uzyskać bardziej szczegółowe informacje 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 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 . Aplikacja może uzyskać bardziej szczegółowe informacje 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 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 . Wartości PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnego zbioru 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 określisz lokalizację, wyniki będą uwzględniać tylko miejsca w pobliżu, a nie będą ograniczone do miejsc na danym obszarze. Użyj 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. 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). |
Interfejs PlaceDetailsRequest
google.maps.places.PlaceDetailsRequest
interfejs
Zapytanie o szczegóły miejsca wysłane do usługi PlacesService
.
Właściwości | |
---|---|
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 na stronie PlaceResult . Pola zagnieżdżone można określić za pomocą ścieżek kropkowych (np. "geometry.location" ). |
language optional |
Typ:
string optional Identyfikator języka, w którym powinny zostać zwrócone 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 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 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”). |
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.FindPlaceFromPhoneNumberRequest
interfejs
Wysłać do PlacesService.findPlaceFromPhoneNumber
prośbę o wyszukiwanie miejsca z zapytania o wyszukiwanie tekstowe.
Właściwości | |
---|---|
fields |
Typ:
Array<string> Pola do uwzględnienia w odpowiedzi, za które będzie naliczana opłata. 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 na stronie 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, 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 FindPlaceFromQueryRequest
google.maps.places.FindPlaceFromQueryRequest
interfejs
Wysłać do PlacesService.findPlaceFromQuery
prośbę o wyszukiwanie miejsca z zapytania o wyszukiwanie tekstowe.
Właściwości | |
---|---|
fields |
Typ:
Array<string> Pola do uwzględnienia w odpowiedzi, za które będzie naliczana opłata. 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 na stronie 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.PlaceSearchRequest
interfejs
Zapytanie dotyczące wyszukiwania miejsc, 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 zostaną zignorowane. |
keyword optional |
Typ:
string optional Wyrażenie do dopasowywania we wszystkich dostępnych polach, w tym m.in. w nazwie, typie i adresie, a także w opiniach klientów i innych treściach pochodzących od innych firm. |
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ńsza) do 4 (najdroższa) włącznie. Musi być równa lub większa niż minPrice , jeśli została określona. |
minPriceLevel optional |
Typ:
number optional Ogranicza wyniki tylko do miejsc o określonej lub wyższej cenie. Prawidłowe wartości to od 0 (najtańsza) do 4 (najdroższa) włącznie. Musi być równa lub mniejsza niż maxPrice , jeśli została określona. |
|
Typ:
string optional Odpowiednik: keyword . Wartości w tym polu są łączone z wartościami w polu keyword i przekazywane jako część 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 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ę rankingu, 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 Wyszukuje miejsc danego typu. Typ jest tłumaczony na język lokalizacji docelowej lokalizacji i używany jako ciąg znaków zapytania. Jeśli podasz też zapytanie, zostanie ono złączone z lokalizowanym ciągiem znaków 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. |
Interfejs TextSearchRequest
google.maps.places.TextSearchRequest
interfejs
Prośba o wyszukiwanie tekstu zostanie wysłana na adres PlacesService
.
Właściwości | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional Granice używane do ukierunkowania wyników podczas wyszukiwania miejsc (opcjonalnie). Jeśli ustawiona jest wartość bounds , zarówno location , jak i radius zostaną zignorowane. Wyniki nie będą ograniczone do tych, które mieszczą się w tych granicach, ale wyniki w ich obrębie 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 zniekształcania wyników wyszukiwania miejsc. |
query optional |
Typ:
string optional Wyszukiwane hasło. Na przykład nazwa miejsca (np. „Wieża Eiffla”), kategoria z nazwą miejsca (np. „pizza w Nowym Jorku”) lub nazwa miejsca z elementem rozróżniającym (np. „Starbucks w Sydney”). |
radius optional |
Typ:
number optional Promień obszaru używany do ukierunkowania wyników wyszukiwania 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 miejsc danego typu. Typ jest tłumaczony na język lokalizacji docelowej lokalizacji i używany jako ciąg znaków zapytania. Jeśli podasz też zapytanie, zostanie ono złączone z lokalizowanym ciągiem znaków 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
google.maps.places.RankBy
stałe
Opcje rankingu dla PlaceSearchRequest.
Dostęp przez połączenie telefoniczne const {RankBy} = await google.maps.importLibrary("places")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
DISTANCE |
Ustawia wyniki według odległości od lokalizacji. |
PROMINENCE |
Wyniki są sortowane według ich ważnoś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 to ścisłe ograniczenie stosowane podczas wyszukiwania miejsc.
stałe PlacesServiceStatus
google.maps.places.PlacesServiceStatus
stałe
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 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 miejsca, do którego odwołuje się ten kod błędu. |
OK |
Odpowiedź zawiera prawidłowy wynik. |
OVER_QUERY_LIMIT |
Aplikacja przekroczyła limit żądań. |
REQUEST_DENIED |
Aplikacja nie może korzystać z funkcji 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 żadnych wyników dla tego zapytania. |
Interfejs PlaceSearchPagination
google.maps.places.PlaceSearchPagination
interfejs
Obiekt służący do pobierania dodatkowych stron wyników wyszukiwania w usłudze Places.
Właściwości | |
---|---|
hasNextPage |
Typ:
boolean Wskazuje, czy są dostępne kolejne wyniki. true gdy jest dostępna dodatkowa strona wyników. |
Metody | |
---|---|
nextPage |
nextPage() Parametry: brak
Zwracana wartość: brak
Pobiera kolejną 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.PlaceResult
interfejs
Określa informacje o miejscu.
Właściwości | |
---|---|
address_components optional |
Typ:
Array<GeocoderAddressComponent> 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ępne tylko w PlacesService.getDetails . |
aspects optional |
Typ:
Array<PlaceAspectRating> optional Ocenione aspekty tego Miejsca na podstawie opinii użytkowników 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 otwarte 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 konwencją regionalną. 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 html_attributions są zawsze zwracane niezależnie od tego, jakie fields zostały zażądane, i muszą być wyświetlane. |
icon optional |
Typ:
string optional Adres URL zasobu z obrazem, który może reprezentować kategorię 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 Obcięty URL maski ikony. Dostęp do różnych typów ikon uzyskasz, 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 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 czy tymczasowo. Jeśli miejsce jest otwarte lub jeśli nie ma dostępnych danych, 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 Open Location lub „Plus Code” dla danego miejsca. |
price_level optional |
Typ:
number optional Poziom ceny Miejsca na skali od 0 do 4. Poziomy cen są interpretowane w ten sposób:
|
rating optional |
Typ:
number optional Ocena (1, 0–5, 0) na podstawie opinii użytkowników o danym 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ępne tylko w PlacesService.getDetails . |
user_ratings_total optional |
Typ:
number optional Liczba ocen użytkowników, które przyczyniły się do PlaceResult.rating danego Miejsca. |
|
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 w przypadku Republiki 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, które są przesunięte w stosunku do UTC, przesunięcie jest ujemne. Na przykład utc_offset_minutes to -60 w przypadku Republiki Zielonego Przylądka. Dostępne tylko w 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.PlaceAspectRating
interfejs
Określa informacje o danym aspekcie miejsca, które użytkownicy ocenili w recenzjach.
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 zbiorczych ocen miejsca jest to liczba całkowita z zakresu 0–30. |
type |
Typ:
string Typ aspektu. Na przykład "food" , "decor" , "service" lub "overall" . |
stałe BusinessStatus
google.maps.places.BusinessStatus
stałe
Stan operacyjny Miejsca, jeśli jest to firma, zwracany 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 const {BusinessStatus} = await google.maps.importLibrary("places")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
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.PlaceGeometry
interfejs
Określa informacje o geometrii miejsca.
Właściwości | |
---|---|
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
google.maps.places.PlaceOpeningHours
interfejs
Określa informacje o godzinach otwarcia miejsca.
Właściwości | |
---|---|
|
Typ:
boolean optional Czy miejsce jest obecnie otwarte. |
periods optional |
Typ:
Array<PlaceOpeningHoursPeriod> 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ępne tylko w PlacesService.getDetails . Inne wywołania mogą zwracać pustą tablicę. |
Metody | |
---|---|
isOpen |
isOpen([date]) Parametry:
Wartość zwracana:
boolean|undefined Sprawdź, czy miejsce jest otwarte teraz (jeśli nie podano daty) lub w określonym dniu. Jeśli to miejsce nie ma PlaceResult.utc_offset_minutes ani PlaceOpeningHours.periods , zwracana jest wartość undefined (wartość PlaceOpeningHours.periods jest dostępna tylko przez PlacesService.getDetails ). Ta metoda nie uwzględnia godzin otwarcia w wyjątkowych sytuacjach, np. w dni świąteczne. |
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 okres open
zawierający day
o wartości 0
i time
o wartości "0000"
, bez close
.
Właściwości | |
---|---|
open |
Godziny otwarcia miejsca. |
close optional |
Typ:
PlaceOpeningHoursTime optional Godzina zamknięcia miejsca. |
Interfejs PlaceOpeningHoursTime
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 ], zaczynając 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 Godzina w formacie 24-godzinnym „hhmm”. 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 on 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
google.maps.places.PlacePlusCode
interfejs
Określa kody Open Location Codes lub „kody plus” 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).
Właściwości | |
---|---|
global_code |
Typ:
string Kod plus z dokładnością do 1/8000 stopnia na 1/8000 stopnia. Na przykład: "8FVC9G8F+5W" . |
compound_code optional |
Typ:
string optional Kod plusa z dokładnością do 1/8000 stopnia na 1/8000 stopnia, w którym pierwsze 4 znaki (kod regionu) są pomijane i zastępowane opisem lokalizacji. Na przykład: "9G8F+5W Zurich, Switzerland" . Jeśli nie można znaleźć odpowiedniej lokalizacji, aby skrócić kod, to pole jest pomijane. |
Interfejs PlacePhoto
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:
Wartość zwracana:
string Zwraca adres URL obrazu odpowiadający określonym opcjom. |
Interfejs PhotoOptions
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ść zwróconego obrazu (w pikselach). |
Interfejs PlaceReview
google.maps.places.PlaceReview
interfejs
Oznacza pojedynczą opinię o miejscu.
Właściwości | |
---|---|
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 recenzenta. |
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. |
|
Typ:
Array<PlaceAspectRating> optional Kwestie ocenione w opinii. Oceny w skali od 0 do 3. |
author_url optional |
Typ:
string optional Adres URL profilu recenzenta. undefined , gdy profil recenzenta jest niedostępny. |
rating optional |
Typ:
number optional Ocena tej opinii, liczba z zakresu 1,0–5,0 (włącznie). |