Klasa PlacesService
google.maps.places.PlacesService
klasa
Zawiera metody związane z wyszukiwaniem miejsc i pobieraniem szczegółowych informacji o miejscu.
Wczytaj za pomocą parametru adresu URL &libraries=places
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {PlacesService} = await google.map.importLibrary("places")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
PlacesService |
PlacesService(attrContainer) Parametry:
Tworzy nowe wystąpienie PlacesService , które renderuje atrybucje w określonym kontenerze. |
Metody | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) Parametry:
Zwróć wartość: brak
Pobiera listę miejsc na podstawie numeru telefonu. W większości przypadków na liście wyników powinno być tylko jeden element, ale jeśli żądanie jest niejednoznaczne, może zostać zwrócony więcej niż jeden wynik. PlaceResult przekazane do wywołania zwrotnego to podzbiór pełnego PlaceResult . Możesz uzyskać bardziej szczegółowe informacje o tym miejscu: PlaceResult . Aby to zrobić, wywołaj funkcję PlacesService.getDetails i przekaż PlaceResult.place_id oczekiwaną lokalizację. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Parametry:
Zwróć wartość: brak
Pobiera listę miejsc na podstawie ciągu zapytania. W większości przypadków na liście wyników powinno być tylko jeden element, ale jeśli żądanie jest niejednoznaczne, może zostać zwrócony więcej niż jeden wynik. PlaceResult przekazane do wywołania zwrotnego to podzbiór pełnego PlaceResult . Możesz uzyskać bardziej szczegółowe informacje o tym miejscu: PlaceResult . Aby to zrobić, wywołaj funkcję PlacesService.getDetails i przekaż PlaceResult.place_id oczekiwaną lokalizację. |
getDetails |
getDetails(request, callback) Parametry:
Zwróć wartość: brak
Pobiera informacje o miejscu zidentyfikowanym przez podane dane placeId . |
nearbySearch |
nearbySearch(request, callback) Parametry:
Zwróć wartość: brak
Pobiera listę miejsc znajdujących się w pobliżu określonej lokalizacji na podstawie słowa kluczowego lub typu. Musisz zawsze podać lokalizację za pomocą parametrów LatLngBounds lub location i radius . PlaceResult przekazane do wywołania zwrotnego to podzbiór pełnego PlaceResult . Możesz uzyskać bardziej szczegółowe PlaceResult informacje o każdym miejscu, wysyłając żądanie szczegółów miejsca, które przekazuje PlaceResult.place_id dla danego miejsca. Obiekt PlaceSearchPagination może służyć do pobierania dodatkowych stron wyników (wartość null, jeśli jest to ostatnia strona wyników lub tylko jedna strona wyników). |
textSearch |
textSearch(request, callback) Parametry:
Zwróć wartość: brak
Pobiera listę miejsc na podstawie ciągu zapytania (np. „pizza w Krakowie” lub „sklepy z obuwiem w pobliżu Warszawy”). Parametry lokalizacji są opcjonalne. Gdy określisz lokalizację, wyniki będą wyświetlane tylko w pobliżu, a nie tylko w pobliżu. Użyj operatora textSearch , jeśli chcesz wyszukiwać miejsca za pomocą dowolnego ciągu znaków, a także wtedy, gdy nie chcesz ograniczać wyników wyszukiwania do określonej lokalizacji. Obiekt PlaceSearchPagination może służyć do pobierania dodatkowych stron wyników (wartość null, jeśli jest to ostatnia strona wyników lub tylko jedna strona wyników). |
Interfejs PlaceDetailsRequest
google.maps.places.PlaceDetailsRequest
interfejs
Zapytanie o miejsce zostanie wysłane do PlacesService
.
Usługi | |
---|---|
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 pytania o szczegóły, przez którą będą naliczane opłaty. Jeśli nie określono żadnych pól lub nie przekazano parametru ['ALL'] , wszystkie dostępne pola są zwracane 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 (na przykład "geometry.location" ). |
language optional |
Typ:
string optional Identyfikator języka, w którym powinny być zwracane szczegóły. Zobacz listę obsługiwanych języków. |
region optional |
Typ:
string optional Kod regionu regionu użytkownika. To może wpłynąć na to, które zdjęcia mogą zostać zwrócone, a nawet na inne rzeczy. Kod regionu może mieć wartość 2-znakową ccTLD („domena 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 kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”). |
sessionToken optional |
Typ:
AutocompleteSessionToken optional Unikalny plik referencyjny używany do łączenia żądania ze szczegółami z sesją autouzupełniania. |
FindPlaceFromPhoneNumberRequest interfejs
google.maps.places.FindPlaceFromPhoneNumberRequest
interfejs
Znajdź miejsce z żądania wyszukiwania tekstowego, które ma zostać wysłane na adres PlacesService.findPlaceFromPhoneNumber
.
Usługi | |
---|---|
fields |
Typ:
Array<string> Pola, które zostaną uwzględnione w odpowiedzi i gdzie zostaną naliczone opłaty. Jeśli pole ['ALL'] zostanie przekazane, zostaną zwrócone wszystkie dostępne pola i rozliczone (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 (na przykład "geometry.location" ). |
phoneNumber |
Typ:
string Numer telefonu miejsca, które chcesz wyszukać. Musi mieć format E.164. |
language optional |
Typ:
string optional Identyfikator języka, w którym powinno się zwracać nazwy i adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków. |
locationBias optional |
Typ:
LocationBias optional Odchylenie używane przy wyszukiwaniu miejsca. Wynik będzie promowany, ale nie ogranicza się do podanej wartości LocationBias . |
Interfejs FindPlaceFromQueryRequest
google.maps.places.FindPlaceFromQueryRequest
interfejs
Znajdź miejsce z żądania wyszukiwania tekstowego, które ma zostać wysłane na adres PlacesService.findPlaceFromQuery
.
Usługi | |
---|---|
fields |
Typ:
Array<string> Pola, które zostaną uwzględnione w odpowiedzi i gdzie zostaną naliczone opłaty. Jeśli pole ['ALL'] zostanie przekazane, zostaną zwrócone wszystkie dostępne pola i rozliczone (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 (na przykład "geometry.location" ). |
query |
Typ:
string Zapytanie. Mogą to być na przykład nazwa lub adres miejsca. |
language optional |
Typ:
string optional Identyfikator języka, w którym powinno się zwracać nazwy i adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków. |
locationBias optional |
Typ:
LocationBias optional Odchylenie używane przy wyszukiwaniu miejsca. Wynik będzie promowany, ale nie ogranicza się do podanej wartości LocationBias . |
Interfejs PlaceSearchRequest
google.maps.places.PlaceSearchRequest
interfejs
Zapytanie dotyczące miejsca wysyłane do usługi PlacesService
.
Usługi | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional Granice, w których trzeba szukać miejsc. Zarówno location , jak i radius będą ignorowane, jeśli ustawisz bounds . |
keyword optional |
Typ:
string optional Wyszukiwane hasło, które ma zostać dopasowane do wszystkich dostępnych pól, w tym do nazw, typów i adresów, a także do opinii klientów i treści innych firm. |
language optional |
Typ:
string optional Identyfikator języka, w którym powinno się zwracać 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 ceny lub niższym. Akceptowane są wartości z zakresu od 0 (najtańszy) do 4 (najdroższy). Wartość musi być równa lub większa niż minPrice , jeśli została określona. |
minPriceLevel optional |
Typ:
number optional Ogranicza wyniki tylko do tych miejsc na określonym poziomie ceny lub wyższym. 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. |
|
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 określonej lokalizacji, w której wyszukiwane są miejsca, w metrach. Maksymalna dozwolona wartość to 50 000. |
rankBy optional |
Typ:
RankBy optional Domyślne:
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 określić location , ale nie możesz określić radius ani bounds . |
type optional |
Typ:
string optional Wyszukuje miejsca danego typu. Typ jest tłumaczony na lokalny język lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli otrzymasz również zapytanie, zostanie ono połączone ze zlokalizowanym ciągiem typu. Wyniki innego typu są usuwane z odpowiedzi. Użyj tego pola, aby wyszukiwać według kategorii niezależnej od języka i regionu. Prawidłowe typy znajdziesz tutaj. |
Interfejs TextSearchRequest
google.maps.places.TextSearchRequest
interfejs
Żądanie wyszukiwania tekstowego wysłane do PlacesService
.
Usługi | |
---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional Ograniczenia używane do promowania wyników podczas wyszukiwania miejsc (opcjonalnie). Zarówno location , jak i radius będą ignorowane, jeśli ustawisz bounds . Wyniki nie będą ograniczone do osób z tych granic, ale znajdujące się w nich wyniki będą zajmować wyższe pozycje w rankingu. |
language optional |
Typ:
string optional Identyfikator języka, w którym powinno się zwracać nazwy i adresy, jeśli to możliwe. Zobacz listę obsługiwanych języków. |
location optional |
Typ:
LatLng|LatLngLiteral optional Środek obszaru użytego do promowania wyników podczas wyszukiwania miejsc. |
query optional |
Typ:
string optional Wyszukiwane hasło żądania. Może to być na przykład nazwa miejsca („Wieża Eiffla”), kategoria, a po niej nazwa lokalizacji („pizza w Krakowie”) lub nazwa lokalu, a następnie identyfikacja lokalizacji („Starbucks w Warszawie”). |
radius optional |
Typ:
number optional Promień obszaru używanego do promowania wyników podczas wyszukiwania miejsc w metrach. |
region optional |
Typ:
string optional Kod regionu, który ma pokazywać odchylenie wyników. Kod regionu może mieć wartość 2-znakową ccTLD („domena 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 kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”). |
type optional |
Typ:
string optional Wyszukuje miejsca danego typu. Typ jest tłumaczony na lokalny język lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli otrzymasz również zapytanie, zostanie ono połączone ze zlokalizowanym ciągiem typu. Wyniki innego typu są usuwane z odpowiedzi. Użyj tego pola, aby wyszukiwać według kategorii niezależnej od języka i regionu. Prawidłowe typy znajdziesz tutaj. |
stałe RankBy
google.maps.places.RankBy
stałe
Opcje rankingu żądania PlaceSearchRequest.
Wczytaj za pomocą parametru adresu URL &libraries=places
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {RankBy} = await google.map.importLibrary("places")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
DISTANCE |
Ranking miejsc plasuje według odległości od lokalizacji. |
PROMINENCE |
Ranking pozycji w rankingu według widoczności. |
Odmiana lokalizacji
google.maps.places.LocationBias
typdefinicji
Funkcja LocationBias reprezentuje miękką granicę lub wskazówkę, która ma być używana podczas wyszukiwania miejsc. Wyniki mogą pochodzić spoza określonego obszaru. Aby można było używać odchylenia adresów bieżącego użytkownika jako adresu, można określić ciąg "IP_BIAS"
. Uwaga: jeśli używasz wartości Circle
, musisz określić środek i promień.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
Typ ograniczenia typu lokalizacji
google.maps.places.LocationRestriction
typdefinicji
Ograniczenie lokalizacji to ścisła granica używana podczas wyszukiwania miejsc.
stałe PlacesServiceStatus
google.maps.places.PlacesServiceStatus
stałe
Stan zwrócony przez PlacesService
po zakończeniu wyszukiwania. Określ je za pomocą wartości lub używając stałej wartości. na przykład 'OK'
lub google.maps.places.PlacesServiceStatus.OK
.
Wczytaj za pomocą parametru adresu URL &libraries=places
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {PlacesServiceStatus} = await google.map.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 używać PlacesService . |
UNKNOWN_ERROR |
Nie można przetworzyć żądania PlacesService z powodu błędu serwera. Jeśli spróbujesz ponownie, prośba może się nie powieść. |
ZERO_RESULTS |
Brak wyników dla tego żądania. |
Interfejs PlaceSearchPagination
google.maps.places.PlaceSearchPagination
interfejs
Obiekt używany do pobierania dodatkowych stron wyników z Miejsc.
Usługi | |
---|---|
hasNextPage |
Typ:
boolean Wskazuje, czy są dostępne dalsze wyniki. true , gdy wyświetla się dodatkowa strona wyników. |
Metody | |
---|---|
nextPage |
nextPage() Parametry: brak
Zwróć wartość: brak
Pobiera następną stronę wyników. Wykorzystuje tę samą funkcję wywołania zwrotnego, która została użyta w pierwszym żądaniu wyszukiwania. |
Interfejs PlaceResult
google.maps.places.PlaceResult
interfejs
Określa informacje o miejscu.
Usługi | |
---|---|
address_components optional |
Typ:
Array<GeocoderAddressComponent> optional Zestaw komponentów adresu związanych z lokalizacją tego miejsca. Dostępne tylko w PlacesService.getDetails . |
adr_address optional |
Typ:
string optional Adres miejsca jest podany w mikroformacie DR. Dostępne tylko w PlacesService.getDetails . |
aspects optional |
Typ:
Array<PlaceAspectRating> optional Oceniane cechy 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 nie ma dostępnych danych, flaga nie jest widoczna w wynikach wyszukiwania ani 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 PlacesService.getDetails . |
geometry optional |
Typ:
PlaceGeometry optional Informacje o geometrii miejsca. |
html_attributions optional |
Typ:
Array<string> optional Tekst atrybucji wyświetlany dla tego wyniku miejsca. Dostępne atrybuty html_attributions są zawsze zwracane niezależnie od tego, o co prosi 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 do użycia z ikoną miejsca. Zobacz również PlaceResult.icon_mask_base_uri . |
icon_mask_base_uri optional |
Typ:
string optional Skrócony URL maski ikony. Uzyskaj dostęp do różnych typów ikon, dodając na końcu rozszerzenia plik (np. .svg lub .png ). |
international_phone_number optional |
Typ:
string optional Numer telefonu 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 miejsca wprowadzonego przez użytkownika jest to nieprzetworzony tekst wpisany przez użytkownika. Zachowaj ostrożność podczas korzystania z tych danych, ponieważ szkodliwi użytkownicy mogą ich używać jako narzędzia do wstrzykiwania kodu (patrz http://pl.wikipedia.org/wiki/Wstrzykiwanie_kodu). |
opening_hours optional |
Typ:
PlaceOpeningHours optional Określa, kiedy miejsce zostanie otwarte lub zamknięte. |
|
Typ:
boolean optional Flaga wskazująca, czy miejsce jest zamknięte na stałe lub tymczasowo. Jeśli miejsce jest aktywne lub nie ma dostępnych danych, flaga nie będzie widoczna 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 otwarte kody lokalizacji lub „kody plus” dla 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 od 1, 0 do 5, 0 na podstawie opinii użytkowników o tym miejscu. |
reviews optional |
Typ:
Array<PlaceReview> optional Lista opinii o tym miejscu. Dostępne tylko w PlacesService.getDetails . |
types optional |
Typ:
Array<string> optional |
url optional |
Typ:
string optional Adres URL oficjalnej strony Google dla tego 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 pomogły opracować PlaceResult.rating miejsca. |
|
Typ:
number optional Przesunięcie względem czasu UTC bieżącej strefy czasowej w minutach. Na przykład czas letni w Australii w strefie czasowej wynosi 11 godzin przed czasem UTC, więc utc_offset będzie wynosić 660 . W przypadku stref czasowych za strefą UTC przesunięcie jest ujemne. Na przykład utc_offset to -60 dla 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 w minutach. Na przykład czas letni w Australii w strefie czasowej wynosi 11 godzin przed czasem UTC, więc utc_offset_minutes będzie wynosić 660 . W przypadku stref czasowych za strefą UTC przesunięcie jest ujemne. Na przykład utc_offset_minutes to -60 dla Zielonego Przylądka. Dostępne tylko w PlacesService.getDetails . |
vicinity optional |
Typ:
string optional Uproszczony adres miejsca obejmujący nazwę ulicy, numer budynku i lokalizację, ale nie nazwę prowincji, stanu, kodu pocztowego ani kraju. Na przykład biuro Google w Sydney ma w pobliżu wartość "48 Pirrama Road, Pyrmont" . Dostępne tylko w PlacesService.getDetails . |
website optional |
Typ:
string optional Wiarygodna strona internetowa dotycząca tego miejsca, np. strona główna firmy. Dostępne tylko w PlacesService.getDetails . |
Interfejs PlaceAspectRating
google.maps.places.PlaceAspectRating
interfejs
Określa informacje o aspekcie miejsca, które ocenili użytkownicy.
Usługi | |
---|---|
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 danego 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" . |
stałe BusinessStatus.
google.maps.places.BusinessStatus
stałe
Stan operacji dotyczącej miejsca (jeśli jest to firma), która została zwrócona w wyniku wyszukiwania miejsca (wskazuje, czy miejsce działa, czy zostało zamknięte tymczasowo lub na stałe). Określ je za pomocą wartości lub nazwy stałej (na przykład 'OPERATIONAL'
lub google.maps.places.BusinessStatus.OPERATIONAL
).
Wczytaj za pomocą parametru adresu URL &libraries=places
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {BusinessStatus} = await google.map.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
Określa informacje o geometrii miejsca.
Usługi | |
---|---|
location optional |
Typ:
LatLng optional Pozycja miejsca. |
viewport optional |
Typ:
LatLngBounds optional Preferowany widok podczas wyświetlania tego miejsca na mapie. Ta właściwość będzie wskazywać null , jeśli preferowany widoczny obszar nie jest znany. Dostępne tylko w PlacesService.getDetails . |
Interfejs PlaceOpeningHours
google.maps.places.PlaceOpeningHours
interfejs
Określa informacje o godzinach otwarcia miejsca.
Usługi | |
---|---|
|
Typ:
boolean optional Wskazuje, 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. Dni, w których miejsce jest zamknięte, nie są uwzględniane. Dostępne tylko w PlacesService.getDetails . |
weekday_text optional |
Typ:
Array<string> optional Tablica 7 ciągów reprezentujących godziny otwarcia w poszczególnych dniach tygodnia. Usługa Miejsca sformatuje godziny otwarcia i odpowiednio je zlokalizuje w bieżącym języku. Kolejność elementów w tej tablicy zależy od języka. Niektóre języki zaczynają się w poniedziałek, a w inne niedziele. Dostępne tylko w PlacesService.getDetails . Inne wywołania mogą zwracać pustą tablicę. |
Metody | |
---|---|
isOpen |
isOpen([date]) Parametry:
Zwrócona wartość:
boolean|undefined Sprawdź, czy miejsce jest teraz otwarte (jeśli data nie minęła) lub w określonym dniu. Jeśli to miejsce nie ma wartości PlaceResult.utc_offset_minutes ani PlaceOpeningHours.periods , funkcja undefined jest zwracana (PlaceOpeningHours.periods jest dostępna tylko przez PlacesService.getDetails ). Ta metoda nie uwzględnia niestandardowych godzin otwarcia, takich jak godziny otwarcia w święto. |
Interfejs PlaceOpeningHoursPeriod
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 zawsze otwarta firma jest reprezentowana jako okres open
zawierający day
z wartością 0
i time
o wartości "0000"
, ale nie close
.
Usługi | |
---|---|
open |
Godzina otwarcia danego miejsca. |
close optional |
Typ:
PlaceOpeningHoursTime optional Godzina zamknięcia miejsca. |
Interfejs PlaceOpeningHoursTime
google.maps.places.PlaceOpeningHoursTime
interfejs
Określa, kiedy dane miejsce jest otwarte lub zamknięte.
Usługi | |
---|---|
day |
Typ:
number Dni tygodnia w postaci liczby w zakresie [ 0 , 6 ], począwszy od niedzieli. Na przykład 2 oznacza wtorek. |
hours |
Typ:
number Godziny PlaceOpeningHoursTime.time w postaci liczby w zakresie [0 , 23 ]. Dane będą raportowane według strefy czasowej miejsca. |
minutes |
Typ:
number Minuty PlaceOpeningHoursTime.time jako liczba w zakresie [0 , 59 ]. Zostanie on podany w strefie czasowej miejsca. |
time |
Typ:
string Godzina w formacie 24-godzinnym. Wartości są w zakresie [ "0000" , "2359" ]. Czas będzie podawany w strefie czasowej miejsca. |
nextDate optional |
Typ:
number optional Sygnatura czasowa (jako milisekunda od początku epoki, odpowiednia dla użycia z new Date() ) reprezentująca następne wystąpienie tego elementu OpenOpeningHoursTime. Oblicza się go na podstawie PlaceOpeningHoursTime.day tygodnia, PlaceOpeningHoursTime.time i PlaceResult.utc_offset_minutes . Jeśli PlaceResult.utc_offset_minutes to undefined , nextDate to undefined . |
Interfejs PlacePlusCode
google.maps.places.PlacePlusCode
interfejs
Określa otwarte kody lokalizacji lub „kody plus” dla miejsc. Kody Plus Code mogą być używane zamiast adresów ulic w miejscach, w których nie istnieją (gdy budynki nie mają numeracji lub nazwy ulic nie są nazwane).
Usługi | |
---|---|
global_code |
Typ:
string Kod plus z 1/8000 stopnia i 1/8000 stopnia. Na przykład: "8FVC9G8F+5W" . |
compound_code optional |
Typ:
string optional Kod plusa z 1/8000 stopnia o 1/8000 stopnia, w którym pierwsze 4 znaki (numer kierunkowy) są usuwane i zastępowane opisem lokalizacji. Na przykład: "9G8F+5W Zurich, Switzerland" . Jeśli nie istnieje odpowiedni rejon, który można skrócić w przypadku kodu, to pole jest pomijane. |
Interfejs PlacePhoto
google.maps.places.PlacePhoto
interfejs
Reprezentuje element zdjęcia danego miejsca.
Usługi | |
---|---|
height |
Typ:
number Wysokość zdjęcia w pikselach. |
html_attributions |
Typ:
Array<string> Tekst atrybucji wyświetlany dla tego zdjęcia. |
width |
Typ:
number Szerokość zdjęcia w pikselach. |
Metody | |
---|---|
getUrl |
getUrl([opts]) Parametry:
Zwrócona wartość:
string Zwraca adres URL obrazu odpowiadający określonym opcjom. |
Interfejs PhotoOptions
google.maps.places.PhotoOptions
interfejs
Określa opcje wysyłania żądań zdjęć.
Usługi | |
---|---|
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 interfejs
google.maps.places.PlaceReview
interfejs
Reprezentuje jedną opinię o miejscu.
Usługi | |
---|---|
author_name |
Typ:
string Imię i nazwisko recenzenta. |
language |
Typ:
string Kod IETF wskazujący język, w którym napisana jest opinia. Pamiętaj, że ten kod obejmuje 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” lub „en-UK”. |
profile_photo_url |
Typ:
string Adres URL zdjęcia profilowego renesansu. |
relative_time_description |
Typ:
string Ciąg znaków w ostatnim czasie w formacie zawierającym czas weryfikacji w stosunku do aktualnej godziny w formacie odpowiednim dla danego języka i kraju. na przykład "a month ago" . |
text |
Typ:
string Tekst opinii. |
time |
Typ:
number Sygnatura czasowa opinii (w sekundach) od początku epoki. |
|
Typ:
Array<PlaceAspectRating> optional Aspekty oceniane w opinii. Oceny w skali od 0 do 3. |
author_url optional |
Typ:
string optional Adres URL profilu recenzenta. Gdy profil recenzenta będzie niedostępny, będzie to wartość undefined . |
rating optional |
Typ:
number optional Ocena tej opinii w przedziale od 1,0 do 5,0 (włącznie). |