Klasa PlacesService
google.maps.places.PlacesService
zajęcia
Zawiera metody związane z wyszukiwaniem miejsc i pobieraniem informacji o miejscu.
Aby uzyskać dostęp, zadzwoń pod numer const {PlacesService} = await google.maps.importLibrary("places")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
PlacesService |
PlacesService(attrContainer) Parametry:
Tworzy nowe wystąpienie obiektu PlacesService , które 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 być tylko jeden element, ale jeśli żądanie jest niejednoznaczne, może zwrócić więcej niż jeden wynik. Elementy PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnych wartości PlaceResult . Twoja 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 być tylko jeden element, ale jeśli żądanie jest niejednoznaczne, może zwrócić więcej niż jeden wynik. Elementy PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnych wartości PlaceResult . Twoja 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 informacje o miejscu wskazanym przez podaną wartość 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ślana za pomocą parametrów LatLngBounds lub location i radius . Elementy PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnych wartości PlaceResult . Aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, wysyłając prośbę o informacje o miejscu przekazującą PlaceResult.place_id dla wybranego miejsca. Obiektu PlaceSearchPagination można używać do pobierania dodatkowych stron z wynikami (wartość null, jeśli jest to ostatnia strona wyników lub jeśli istnieje tylko jedna strona wyników). |
textSearch |
textSearch(request, callback) Parametry:
Zwracana wartość: brak
Pobiera listę miejsc na podstawie ciągu zapytania (np. „pizza w Krakowie” lub „sklepy obuwnicze w pobliżu Warszawy”). Parametry lokalizacji są opcjonalne. Gdy lokalizacja zostanie określona, wyniki będą miały wpływ tylko na wyniki w pobliżu, a nie do miejsc w obrębie danego obszaru. Użyj operatora textSearch , jeśli chcesz wyszukiwać miejsca przy użyciu dowolnego ciągu znaków oraz gdy nie chcesz ograniczać wyników wyszukiwania do konkretnej lokalizacji. Obiektu PlaceSearchPagination można używać do pobierania dodatkowych stron z wynikami (wartość null, jeśli jest to ostatnia strona wyników lub jeśli istnieje tylko jedna strona wyników). |
Interfejs PlaceDetailsRequest
google.maps.places.PlaceDetailsRequest
interfejs
Zapytanie o szczegóły miejsca zostanie wysłane do: PlacesService
.
Właściwości | |
---|---|
placeId |
Typ:
string Identyfikator miejsca, którego dotyczy prośba o podanie szczegółowych informacji. |
fields optional |
Typ:
Array<string> optional Pola, które zostaną uwzględnione w odpowiedzi ze szczegółami, za które będą naliczane opłaty. Jeśli nie podasz żadnych pól lub przekazano ['ALL'] , wszystkie dostępne pola zostaną zwrócone i rozliczane (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult . Zagnieżdżone pola można określać za pomocą ścieżek punktowych (np. "geometry.location" ). |
language optional |
Typ:
string optional Identyfikator języka, w którym należy zwracać szczegóły. Zobacz listę obsługiwanych języków. |
region optional |
Typ:
string optional Kod regionu regionu użytkownika. Może to mieć wpływ na to, które zdjęcia mogą zostać zwrócone, a także na inne kwestie. Kod regionu akceptuje dwuznaczną wartość ccTLD („domena najwyższego poziomu”). Większość kodów domen ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD w Wielkiej Brytanii to „uk” ( .co.uk ), a kod ISO 3166-1 to „gb” (technicznie oznacza to „Wielka Brytania i Irlandia Północna”). |
sessionToken optional |
Typ:
AutocompleteSessionToken optional Unikalne odwołanie używane do łączenia żądania szczegółów z sesją autouzupełniania. |
Interfejs FindPlaceFromPhoneNumberRequest
google.maps.places.FindPlaceFromPhoneNumberRequest
interfejs
Znalezione miejsce z żądania wyszukiwania tekstowego, które ma zostać wysłane na adres PlacesService.findPlaceFromPhoneNumber
.
Właściwości | |
---|---|
fields |
Typ:
Array<string> Pola, które mają być uwzględnione w odpowiedzi, za które będą naliczane opłaty. Jeśli przekażesz pole ['ALL'] , wszystkie dostępne pola zostaną zwrócone i zapłacone (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult . Zagnieżdżone pola można określać za pomocą ścieżek punktowych (np. "geometry.location" ). |
phoneNumber |
Typ:
string Numer telefonu miejsca, które chcesz wyszukać. Wymagany format to E.164. |
language optional |
Typ:
string optional Identyfikator języka, w którym powinny być zwracane imiona i nazwiska oraz adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków. |
locationBias optional |
Typ:
LocationBias optional Odchylenie stosowane przy wyszukiwaniu miejsca. Wynik będzie stronniczy, ale nie tylko w odniesieniu do podanych elementów LocationBias . |
Interfejs FindPlaceFromQueryRequest
google.maps.places.FindPlaceFromQueryRequest
interfejs
Znalezione miejsce z żądania wyszukiwania tekstowego, które ma zostać wysłane na adres PlacesService.findPlaceFromQuery
.
Właściwości | |
---|---|
fields |
Typ:
Array<string> Pola, które mają być uwzględnione w odpowiedzi, za które będą naliczane opłaty. Jeśli przekażesz pole ['ALL'] , wszystkie dostępne pola zostaną zwrócone i zapłacone (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult . Zagnieżdżone pola można określać za pomocą ścieżek punktowych (np. "geometry.location" ). |
query |
Typ:
string Zapytanie. Na przykład nazwa lub adres miejsca. |
language optional |
Typ:
string optional Identyfikator języka, w którym powinny być zwracane imiona i nazwiska oraz adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków. |
locationBias optional |
Typ:
LocationBias optional Odchylenie stosowane przy wyszukiwaniu miejsca. Wynik będzie stronniczy, ale nie tylko w odniesieniu do podanych elementów LocationBias . |
Interfejs PlaceSearchRequest
google.maps.places.PlaceSearchRequest
interfejs
Zapytanie o miejsce, które ma zostać wysłane do interfejsu PlacesService
.
Właściwości | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional Granice wyszukiwania miejsc. Jeśli ustawiona jest wartość bounds , wartości location i radius zostaną zignorowane. |
keyword optional |
Typ:
string optional Hasło, które ma zostać dopasowane do wszystkich dostępnych pól, takich jak nazwa, typ i adres, a także opinie klientów i inne treści firm zewnętrznych. |
language optional |
Typ:
string optional Identyfikator języka, w którym powinny być zwracane imiona i nazwiska oraz adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków. |
location optional |
Typ:
LatLng|LatLngLiteral optional Lokalizacja, w obrębie której wyszukiwane są miejsca. |
maxPriceLevel optional |
Typ:
number optional Ogranicza wyniki tylko do tych miejsc na określonym lub niższym poziomie cenowym. Prawidłowe wartości mieszczą się w przedziale od 0 (najbardziej przystępna cena) do 4 (najdroższa) 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 tych miejsc na określonym lub wyższym poziomie cenowym. Prawidłowe wartości mieszczą się w przedziale od 0 (najbardziej przystępna cena) do 4 (najdroższa) włącznie. Wartość nie może być większa 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 tych miejsc, które są w danej chwili otwarte. |
radius optional |
Typ:
number optional Odległość od danej lokalizacji, w której należy szukać miejsc (w metrach). Maksymalna dozwolona wartość to 50 000. |
rankBy optional |
Typ:
RankBy optional Wartość domyślna:
RankBy.PROMINENCE Określa metodę rankingu używaną przy zwracaniu wyników. Pamiętaj, że gdy rankBy ma wartość DISTANCE , musisz określić location , ale nie możesz określić radius ani bounds . |
type optional |
Typ:
string optional Wyszukuje miejsca określonego typu. Typ jest przekładany na język lokalny lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli podane jest też zapytanie, jest ono łączone ze zlokalizowanym ciągiem typu. Wyniki innego typu zostaną usunięte z odpowiedzi. Użyj tego pola, aby przeprowadzić wyszukiwanie kategorialne niezależne od języka i regionu. Prawidłowe typy znajdziesz tutaj. |
Interfejs TextSearchRequest
google.maps.places.TextSearchRequest
interfejs
Żądanie wyszukiwania tekstu do wysłania do: PlacesService
.
Właściwości | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional Ograniczenia używane do uporządkowania wyników podczas wyszukiwania miejsc (opcjonalnie). Jeśli ustawiona jest wartość bounds , wartości location i radius zostaną zignorowane. Wyniki nie będą ograniczone do tych znajdujących się w tych granicach, ale wyniki w obrębie tych granic będą miały wyższą pozycję w rankingu. |
language optional |
Typ:
string optional Identyfikator języka, w którym powinny być zwracane imiona i nazwiska oraz adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków. |
location optional |
Typ:
LatLng|LatLngLiteral optional Środek obszaru używanego do promowania wyników wyszukiwania miejsc. |
query optional |
Typ:
string optional Zapytanie. Na przykład nazwa miejsca („Wieża Eiffla”), kategoria, po której następuje nazwa lokalizacji („pizza w Nowym Jorku”) lub nazwa miejsca, po którym następuje wybór lokalizacji („Starbucks w Sydney”). |
radius optional |
Typ:
number optional Promień obszaru (w metrach) używany do promowania wyników podczas wyszukiwania miejsc. |
region optional |
Typ:
string optional Kod regionu, na który mają być kierowane wyniki. Kod regionu akceptuje dwuznaczną wartość ccTLD („domena najwyższego poziomu”). Większość kodów domen ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD w Wielkiej Brytanii to „uk” ( .co.uk ), a kod ISO 3166-1 to „gb” (technicznie oznacza to „Wielka Brytania i Irlandia Północna”). |
type optional |
Typ:
string optional Wyszukuje miejsca określonego typu. Typ jest przekładany na język lokalny lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli podane jest też zapytanie, jest ono łączone ze zlokalizowanym ciągiem typu. Wyniki innego typu zostaną usunięte z odpowiedzi. Użyj tego pola, aby przeprowadzić wyszukiwanie kategorialne niezależne od języka i regionu. Prawidłowe typy znajdziesz tutaj. |
RankBy
google.maps.places.RankBy
stałe
Opcje rankingu dla żądania PlaceSearchRequest.
Aby uzyskać dostęp, zadzwoń pod numer const {RankBy} = await google.maps.importLibrary("places")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
DISTANCE |
Ranking wyników wyszukiwania miejsc według odległości od lokalizacji. |
PROMINENCE |
Ranking wyników miejsc według ich widoczności. |
LocationBias typedef
google.maps.places.LocationBias
typedef
LocationBias to łagodna granica lub wskazówka do wykorzystania 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 elementu Circle
, musisz określić środek i promień.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
typedef
Ograniczenie lokalizacji określa ścisłą granicę przy wyszukiwaniu miejsc.
Stałe PlacesServiceStatus
google.maps.places.PlacesServiceStatus
stałe
Stan zwrócony przez PlacesService
po zakończeniu wyszukiwania. Określ je według wartości lub nazwy stałej. Na przykład 'OK'
lub google.maps.places.PlacesServiceStatus.OK
.
Aby uzyskać dostęp, zadzwoń pod numer const {PlacesServiceStatus} = await google.maps.importLibrary("places")
. Zobacz Biblioteki w interfejsie 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 może korzystać 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ę powieść. |
ZERO_RESULTS |
Nie znaleziono wyników dla tego żądania. |
Interfejs PlaceSearchPagination
google.maps.places.PlaceSearchPagination
interfejs
Obiekt używany do pobierania dodatkowych stron wyników wyszukiwania w Miejscach.
Właściwości | |
---|---|
hasNextPage |
Typ:
boolean Wskazuje, czy są dostępne dalsze wyniki. true , gdy dostępna jest dodatkowa strona wyników. |
Metody | |
---|---|
nextPage |
nextPage() Parametry: brak
Zwracana wartość: brak
Pobiera następną stronę wyników. Korzysta z tej samej funkcji wywołania zwrotnego, która została podana w pierwszym żądaniu wyszukiwania. |
Interfejs PlaceResult
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 dotyczących lokalizacji tego miejsca. Dostępne tylko w PlacesService.getDetails . |
adr_address optional |
Typ:
string optional Adres miejsca przedstawiany w mikroformacie adr. Dostępne tylko w PlacesService.getDetails . |
aspects optional |
Typ:
Array<PlaceAspectRating> optional Ocenione aspekty tego miejsca na podstawie opinii użytkowników z Google i Zagat. Oceny są prezentowane w skali od 0 do 30. |
business_status optional |
Typ:
BusinessStatus optional flagę wskazującą stan operacyjny danego miejsca, jeśli jest to firma (wskazuje, czy dane miejsce działa, czy jest zamknięte tymczasowo lub na stałe); Jeśli brak danych, oznacza to, że flaga nie wyświetla się w wynikach wyszukiwania i odpowiedziach szczegółowych. |
formatted_address optional |
Typ:
string optional Pełny adres miejsca. |
formatted_phone_number optional |
Typ:
string optional Numer telefonu miejsca sformatowany zgodnie z lokalną konwencją numerów. Dostępne tylko w PlacesService.getDetails . |
geometry optional |
Typ:
PlaceGeometry optional informacje dotyczące geometrii danego miejsca, |
html_attributions optional |
Typ:
Array<string> optional Tekst informacji, który będzie wyświetlany w przypadku tego wyniku wyszukiwania związanego z miejscem. Dostępne html_attributions są zawsze zwracane niezależnie od tego, czego zażądano fields . Muszą być wyświetlane. |
icon optional |
Typ:
string optional Adres URL zasobu graficznego, który może być używany do reprezentowania kategorii tego miejsca. |
icon_background_color optional |
Typ:
string optional Kolor tła do wykorzystania z ikoną miejsca. Zobacz też PlaceResult.icon_mask_base_uri . |
icon_mask_base_uri optional |
Typ:
string optional Obcięty adres URL prowadzący do maski ikony. Aby uzyskać dostęp do różnych typów ikon, dodaj na końcu rozszerzenie pliku (np. .svg lub .png ). |
international_phone_number optional |
Typ:
string optional Numer telefonu danego miejsca w formacie międzynarodowym. Format międzynarodowy obejmuje kod kraju i jest poprzedzony znakiem plusa (+). Dostępne tylko w PlacesService.getDetails . |
name optional |
Typ:
string optional Nazwa miejsca. Uwaga: w przypadku danych wprowadzonych przez użytkownika jest to zwykły tekst wpisany przez użytkownika. Zachowaj ostrożność podczas korzystania z tych danych, ponieważ szkodliwi użytkownicy mogą próbować wykorzystywać je jako wektory do 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 otwierane lub zamykane. |
|
Typ:
boolean optional flagę z informacją, czy miejsce zostało zamknięte na stałe lub tymczasowo; Jeśli miejsce działa lub nie są dostępne żadne dane, w odpowiedzi nie będzie odpowiedniej flagi. |
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 Definiuje otwarte kody lokalizacji, czyli „kody plus” miejsca. |
price_level optional |
Typ:
number optional Poziom cen miejsca w skali od 0 do 4. Poziomy cen są interpretowane w następujący sposób:
|
rating optional |
Typ:
number optional Ocena w przedziale od 1, 0 do 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 |
url optional |
Typ:
string optional URL oficjalnej strony Google dotyczącej tego miejsca. To jest strona należąca do Google, która zawiera najlepsze dostępne informacje o tym miejscu. Dostępne tylko w PlacesService.getDetails . |
user_ratings_total optional |
Typ:
number optional Liczba ocen użytkowników, które przyczyniły się do powstania PlaceResult.rating danego miejsca. |
|
Typ:
number optional Przesunięcie względem czasu UTC bieżącej strefy czasowej miejsca (w minutach). Na przykład w Sydney w Australii czas letni to 11 godzin wcześniej niż UTC, więc utc_offset będzie mieć wartość 660 . W przypadku stref czasowych powyżej 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 Przesunięcie względem czasu UTC bieżącej strefy czasowej miejsca (w minutach). Na przykład w Sydney w Australii czas letni to 11 godzin wcześniej niż UTC, więc utc_offset_minutes będzie mieć wartość 660 . W przypadku stref czasowych powyżej UTC przesunięcie jest ujemne. Na przykład utc_offset_minutes to -60 dla Wysp Zielonego Przylądka. Dostępne tylko w PlacesService.getDetails . |
vicinity optional |
Typ:
string optional uproszczony adres miejsca zawierający nazwę ulicy, numer ulicy i lokalizację, ale nie nazwę prowincji, województwa, kodu pocztowego ani kraju; Na przykład biuro Google w Sydney w Australii ma wartość lokalizacji "48 Pirrama Road, Pyrmont" . Dostępne tylko w PlacesService.getDetails . |
website optional |
Typ:
string optional Wiarygodna witryna dotycząca tego miejsca, np. strona główna firmy. Dostępne tylko w PlacesService.getDetails . |
Interfejs PlaceAspectRating
google.maps.places.PlaceAspectRating
interfejs
Definiuje informacje o aspektach miejsca ocenionych przez użytkowników.
Właściwości | |
---|---|
rating |
Typ:
number Ocena tego aspektu. W przypadku poszczególnych opinii jest to liczba całkowita od 0 do 3. W przypadku zagregowanych ocen miejsca jest to liczba całkowita od 0 do 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 danego miejsca (jeśli jest to firma), zwracany w wyniku PlaceResult (wskazuje, czy miejsce działa, czy jest 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
).
Aby uzyskać dostęp, zadzwoń pod numer const {BusinessStatus} = await google.maps.importLibrary("places")
. Zobacz Biblioteki w interfejsie 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. |
Interfejs PlaceGeometry
google.maps.places.PlaceGeometry
interfejs
Definiuje informacje o geometrii miejsca.
Właściwości | |
---|---|
location optional |
Typ:
LatLng optional Pozycja miejsca. |
viewport optional |
Typ:
LatLngBounds optional Preferowany widoczny obszar wyświetlania tego miejsca na mapie. Jeśli preferowany widoczny obszar dla miejsca nie jest znany, ta właściwość przyjmuje wartość null . Dostępne tylko w PlacesService.getDetails . |
Interfejs PlaceOpeningHours
google.maps.places.PlaceOpeningHours
interfejs
Definiuje informacje o godzinach otwarcia miejsca.
Właściwości | |
---|---|
|
Typ:
boolean optional Określa, czy miejsce jest otwarte w danej chwili. |
periods optional |
Typ:
Array<PlaceOpeningHoursPeriod> optional Okresy otwarcia obejmujące każdy dzień tygodnia od niedzieli w kolejności chronologicznej. Dni, w których Miejsce nie jest otwarte, nie są uwzględniane. Dostępne tylko w PlacesService.getDetails . |
weekday_text optional |
Typ:
Array<string> optional Tablica 7 ciągów znaków reprezentujących sformatowane godziny otwarcia dla każdego dnia tygodnia. Usługa Miejsca odpowiednio sformatuje i zlokalizuje godziny otwarcia pod kątem aktualnego języka. Kolejność elementów w tej tablicy zależy od języka. W przypadku niektórych języków tydzień rozpoczyna się w poniedziałek, a w innych w niedzielę. Dostępne tylko w PlacesService.getDetails . Inne wywołania mogą zwracać pustą tablicę. |
Metody | |
---|---|
isOpen |
isOpen([date]) Parametry:
Wartość zwrotu:
boolean|undefined Sprawdź, czy miejsce jest otwarte teraz (gdy nie minęła żadna data), czy w określonym dniu. Jeśli to miejsce nie ma PlaceResult.utc_offset_minutes ani PlaceOpeningHours.periods , zwracana jest wartość undefined (PlaceOpeningHours.periods jest dostępna tylko przez PlacesService.getDetails ). Ta metoda nie uwzględnia wyjątkowych godzin pracy, takich jak godziny otwarcia w święto. |
Interfejs PlaceOpeningHoursPeriod
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ą polegać na tym, że funkcja zawsze otwarta jest reprezentowana jako okres open
zawierający day
z wartościami 0
i time
o wartości "0000"
, ale bez ze stanem close
.
Właściwości | |
---|---|
open |
Godzina otwarcia miejsca. |
close optional |
Typ:
PlaceOpeningHoursTime optional Godzina zamknięcia miejsca. |
Interfejs PlaceOpeningHoursTime
google.maps.places.PlaceOpeningHoursTime
interfejs
Określa, kiedy miejsce jest otwierane lub zamykane.
Właściwości | |
---|---|
day |
Typ:
number Dni tygodnia jako liczba z zakresu [ 0 , 6 ], począwszy od niedzieli. Na przykład 2 oznacza wtorek. |
hours |
Typ:
number Godzina PlaceOpeningHoursTime.time jako liczba w zakresie [0 , 23 ]. Zostanie podana w strefie czasowej miejsca. |
minutes |
Typ:
number Minuty PlaceOpeningHoursTime.time jako liczby w zakresie [0 , 59 ]. Dane będą podawane w strefie czasowej miejsca. |
time |
Typ:
string Godzina w 24-godzinnym formacie „ggmm”. Wartości mieszczą się w zakresie [ "0000" , "2359" ]. Godzina będzie podana w strefie czasowej miejsca. |
nextDate optional |
Typ:
number optional Sygnatura czasowa (w milisekundach od początku epoki, odpowiednia do użycia z elementem new Date() ) reprezentująca następne wystąpienie tego elementu PlaceOpeningHoursTime. Oblicza się go na podstawie PlaceOpeningHoursTime.day tygodnia oraz PlaceOpeningHoursTime.time i PlaceResult.utc_offset_minutes . Jeśli PlaceResult.utc_offset_minutes to undefined , nextDate ma wartość undefined . |
Interfejs PlacePlusCode
google.maps.places.PlacePlusCode
interfejs
Definiuje otwarte kody lokalizacji, czyli „kody plus” miejsca. Kody Plus Code mogą zastąpić adresy w miejscach, gdzie nie istnieją (gdzie budynki nie są numerowane lub nie mają nazw ulic).
Właściwości | |
---|---|
global_code |
Typ:
string Kod plus z zapisem 1/8000 stopnia i 1/8000 pola stopnia. Na przykład: "8FVC9G8F+5W" . |
compound_code optional |
Typ:
string optional Kod plus o szerokości 1/8000 stopnia i 1/8000 stopnia, gdzie pierwsze 4 znaki (numer kierunkowy) są usuwane i zastępowane opisem miejscowości. Na przykład: "9G8F+5W Zurich, Switzerland" . W przypadku braku odpowiedniego rejonu, w którym można skrócić kod, to pole zostanie pominięte. |
Interfejs PlacePhoto
google.maps.places.PlacePhoto
interfejs
Reprezentuje element zdjęcia danego miejsca.
Właściwości | |
---|---|
height |
Typ:
number Wysokość zdjęcia w pikselach. |
html_attributions |
Typ:
Array<string> Tekst oznaczenia, który będzie wyświetlany dla tego zdjęcia. |
width |
Typ:
number Szerokość zdjęcia w pikselach. |
Metody | |
---|---|
getUrl |
getUrl([opts]) Parametry:
Wartość zwrotu:
string Zwraca adres URL obrazu odpowiadający określonym opcjom. |
Interfejs PhotoOptions
google.maps.places.PhotoOptions
interfejs
Pozwala określić opcje wysyłania próśb o zdjęcia.
Właściwości | |
---|---|
maxHeight optional |
Typ:
number optional Maksymalna wysokość zwróconego obrazu w pikselach. |
maxWidth optional |
Typ:
number optional Maksymalna szerokość zwracanego obrazu w pikselach. |
Interfejs PlaceReview
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 opinia. Pamiętaj, że ten kod zawiera tylko główny tag języka bez żadnego dodatkowego tagu wskazującego kraj lub region. Na przykład wszystkie opinie w języku angielskim są oznaczone tagiem 'en' , a nie „en-AU” czy „en-UK”. |
profile_photo_url |
Typ:
string Adres URL zdjęcia profilowego na koncie. |
relative_time_description |
Typ:
string Ciąg sformatowany ostatnio czas, w którym podano czas sprawdzania w stosunku do bieżącego czasu, w formie odpowiedniej dla danego języka i kraju. Przykład: "a month ago" . |
text |
Typ:
string Tekst opinii. |
time |
Typ:
number Sygnatura czasowa sprawdzenia 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 autora opinii. Gdy profil osoby sprawdzającej będzie niedostępny, nagra się undefined . |
rating optional |
Typ:
number optional Ocena tej opinii, liczbą od 1,0 do 5,0 (włącznie). |