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.PlaceDetailsRequestinterfejs
Zapytanie o szczegóły miejsca wysłane do usługi PlacesService.
Właściwości | |
|---|---|
placeId |
Typ:
stringIdentyfikator miejsca, którego dotyczy żądanie szczegółów. |
fields optional |
Typ:
Array<string> optionalPola, 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 optionalIdentyfikator języka, w którym powinny zostać zwrócone szczegóły. Zobacz listę obsługiwanych języków. |
region optional |
Typ:
string optionalKod 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 optionalUnikalne odwołanie służące do zgrupowania żądania szczegółów z sesją autouzupełniania. |
Interfejs FindPlaceFromPhoneNumberRequest
google.maps.places.FindPlaceFromPhoneNumberRequestinterfejs
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:
stringNumer telefonu miejsca, które chcesz wyszukać. Format musi być E.164. |
language optional |
Typ:
string optionalIdentyfikator 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 optionalUstawienie 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.FindPlaceFromQueryRequestinterfejs
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:
stringZapytanie. Na przykład nazwę lub adres miejsca. |
language optional |
Typ:
string optionalIdentyfikator 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 optionalUstawienie 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.PlaceSearchRequestinterfejs
Zapytanie dotyczące wyszukiwania miejsc, które ma zostać wysłane do PlacesService.
Właściwości | |
|---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optionalGranice, 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 optionalWyraż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 optionalIdentyfikator 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 optionalLokalizacja, w pobliżu której mają być wyszukiwane miejsca. |
maxPriceLevel optional |
Typ:
number optionalOgranicza 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 optionalOgranicza 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 optionalOdpowiednik: 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 optionalOgranicza wyniki tylko do miejsc, które są obecnie otwarte. |
radius optional |
Typ:
number optionalOdległość od danej lokalizacji, w której wyszukiwane są Miejsca, w metrach. Maksymalna dozwolona wartość to 50 000. |
rankBy optional |
Typ:
RankBy optionalDomyślnie:
RankBy.PROMINENCEOkreś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 optionalWyszukuje 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.TextSearchRequestinterfejs
Prośba o wyszukiwanie tekstu zostanie wysłana na adres PlacesService.
Właściwości | |
|---|---|
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optionalGranice 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 optionalIdentyfikator 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 optionalWyszukiwane 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 optionalPromień obszaru używany do ukierunkowania wyników wyszukiwania miejsc w metrach. |
region optional |
Typ:
string optionalKod 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 optionalWyszukuje 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.PlaceSearchPaginationinterfejs
Obiekt służący do pobierania dodatkowych stron wyników wyszukiwania w usłudze Places.
Właściwości | |
|---|---|
hasNextPage |
Typ:
booleanWskazuje, czy są dostępne kolejne wyniki. true gdy jest dostępna dodatkowa strona wyników. |
Metody | |
|---|---|
nextPage |
nextPage()Parametry: brak
Wartość zwracana:
voidPobiera 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.PlaceResultinterfejs
Określa informacje o miejscu.
Właściwości | |
|---|---|
address_components optional |
Typ:
Array<GeocoderAddressComponent> optionalZbiór elementów adresu dla lokalizacji danego Miejsca. Dostępne tylko w PlacesService.getDetails. |
adr_address optional |
Typ:
string optionalAdres miejsca w mikroformacie adresu. Dostępne tylko w PlacesService.getDetails. |
aspects optional |
Typ:
Array<PlaceAspectRating> optionalOcenione 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 optionalFlaga 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 optionalPełny adres Miejsca. |
formatted_phone_number optional |
Typ:
string optionalNumer telefonu Miejsca sformatowany zgodnie z konwencją regionalną. Dostępne tylko w PlacesService.getDetails. |
geometry optional |
Typ:
PlaceGeometry optionalInformacje o geometrii Miejsca. |
html_attributions optional |
Typ:
Array<string> optionalTekst 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 optionalAdres URL zasobu z obrazem, który może reprezentować kategorię Miejsca. |
icon_background_color optional |
Typ:
string optionalKolor tła do użycia z ikoną Miejsca. Zobacz też PlaceResult.icon_mask_base_uri. |
icon_mask_base_uri optional |
Typ:
string optionalObcię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 optionalNumer 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 optionalNazwa 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 optionalOkreśla, kiedy Miejsce jest otwarte lub zamknięte. |
|
Typ:
boolean optionalFlaga 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> optionalZdjęcia tego miejsca. Kolekcja będzie zawierać maksymalnie 10 obiektów PlacePhoto. |
place_id optional |
Typ:
string optionalUnikalny identyfikator miejsca. |
plus_code optional |
Typ:
PlacePlusCode optionalOkreśla kody Open Location lub „Plus Code” dla danego miejsca. |
price_level optional |
Typ:
number optionalPoziom ceny Miejsca na skali od 0 do 4. Poziomy cen są interpretowane w ten sposób:
|
rating optional |
Typ:
number optionalOcena (1, 0–5, 0) na podstawie opinii użytkowników o danym Miejscu. |
reviews optional |
Typ:
Array<PlaceReview> optionallista opinii o tym miejscu; Dostępne tylko w PlacesService.getDetails. |
types optional |
Typ:
Array<string> optionalTablica typów tego Miejsca (na przykład ["political", "locality"] lub ["restaurant", "establishment"]). |
url optional |
Typ:
string optionalAdres 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 optionalLiczba ocen użytkowników, które przyczyniły się do PlaceResult.rating danego Miejsca. |
|
Typ:
number optionalOdchylenie 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 optionalOdchylenie 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 optionalUproszczony 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 optionalWitryna internetowa powiązana z tym miejscem, np. strona główna firmy. Dostępne tylko w PlacesService.getDetails. |
Interfejs PlaceAspectRating
google.maps.places.PlaceAspectRatinginterfejs
Określa informacje o danym aspekcie miejsca, które użytkownicy ocenili w recenzjach.
Właściwości | |
|---|---|
rating |
Typ:
numberOcena 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:
stringTyp 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.PlaceGeometryinterfejs
Określa informacje o geometrii miejsca.
Właściwości | |
|---|---|
location optional |
Typ:
LatLng optionalPołożenie Miejsca. |
viewport optional |
Typ:
LatLngBounds optionalPreferowany 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.PlaceOpeningHoursinterfejs
Określa informacje o godzinach otwarcia miejsca.
Właściwości | |
|---|---|
|
Typ:
boolean optionalCzy miejsce jest obecnie otwarte. |
periods optional |
Typ:
Array<PlaceOpeningHoursPeriod> optionalokresy 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> optionalTablica 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|undefinedSprawdź, 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.PlaceOpeningHoursPeriodinterfejs
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 optionalGodzina zamknięcia miejsca. |
Interfejs PlaceOpeningHoursTime
google.maps.places.PlaceOpeningHoursTimeinterfejs
Określa, kiedy miejsce jest otwarte lub zamknięte.
Właściwości | |
|---|---|
day |
Typ:
numberDni tygodnia jako liczby z zakresu [ 0, 6], zaczynając od niedzieli. Na przykład 2 oznacza wtorek. |
hours |
Typ:
numberGodziny PlaceOpeningHoursTime.time jako liczba z zakresu [0, 23]. Dane te będą podawane w strefie czasowej Miejsca. |
minutes |
Typ:
numberLiczba minut PlaceOpeningHoursTime.time w zakresie [0, 59]. Będzie ona podana w strefie czasowej miejsca. |
time |
Typ:
stringGodzina 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 optionalSygnatura 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.PlacePlusCodeinterfejs
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:
stringKod plus z dokładnością do 1/8000 stopnia na 1/8000 stopnia. Na przykład: "8FVC9G8F+5W". |
compound_code optional |
Typ:
string optionalKod 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.PlacePhotointerfejs
Reprezentuje element zdjęcia Miejsca.
Właściwości | |
|---|---|
height |
Typ:
numberWysokość 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:
numberSzerokość zdjęcia w pikselach. |
Metody | |
|---|---|
getUrl |
getUrl([opts])Parametry:
Wartość zwracana:
stringZwraca adres URL obrazu odpowiadający określonym opcjom. |
Interfejs PhotoOptions
google.maps.places.PhotoOptionsinterfejs
Określa opcje żądania zdjęć.
Właściwości | |
|---|---|
maxHeight optional |
Typ:
number optionalMaksymalna wysokość zwracanego obrazu (w pikselach). |
maxWidth optional |
Typ:
number optionalMaksymalna szerokość zwróconego obrazu (w pikselach). |
Interfejs PlaceReview
google.maps.places.PlaceReviewinterfejs
Oznacza pojedynczą opinię o miejscu.
Właściwości | |
|---|---|
author_name |
Typ:
stringImię i nazwisko osoby, która przesłała opinię. |
language |
Typ:
stringKod 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:
stringAdres URL zdjęcia profilowego recenzenta. |
relative_time_description |
Typ:
stringFormatowany 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:
stringTekst opinii. |
time |
Typ:
numberSygnatura czasowa recenzji wyrażona w sekundach od początku epoki. |
|
Typ:
Array<PlaceAspectRating> optionalKwestie ocenione w opinii. Oceny w skali od 0 do 3. |
author_url optional |
Typ:
string optionalAdres URL profilu recenzenta. undefined, gdy profil recenzenta jest niedostępny. |
rating optional |
Typ:
number optionalOcena tej opinii, liczba z zakresu 1,0–5,0 (włącznie). |