Places Service (deprecated)

PlacesService

klasa google.maps.places.PlacesService
biblioteka "places"

Zawiera metody związane z wyszukiwaniem miejsc i pobieraniem szczegółowych informacji o miejscu.

const {PlacesService} = await google.maps.importLibrary("places");
PlacesService
PlacesService(attrContainer)
Parametry:
Tworzy nową instancję PlacesService, która renderuje atrybucje w określonym kontenerze.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parametry:
Zwracana wartość: brak
Pobiera listę miejsc na podstawie numeru telefonu. W większości przypadków na liście wyników powinien znajdować się tylko 1 element, ale jeśli żądanie jest niejednoznaczne, może zostać zwróconych więcej wyników. Obiekty PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnego obiektu PlaceResult. Aplikacja może uzyskać bardziej szczegółowe informacje (PlaceResult) o każdym miejscu, wywołując PlacesService.getDetails i przekazując PlaceResult.place_id dla wybranego miejsca.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parametry:
Zwracana wartość: brak
Pobiera listę miejsc na podstawie ciągu zapytania. W większości przypadków na liście wyników powinien znajdować się tylko 1 element, ale jeśli żądanie jest niejednoznaczne, może zostać zwróconych więcej wyników. Obiekty PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnego obiektu PlaceResult. Aplikacja może uzyskać bardziej szczegółowe informacje (PlaceResult) o każdym miejscu, wywołując metodę PlacesService.getDetails i przekazując parametr PlaceResult.place_id dla wybranego miejsca.
getDetails
getDetails(request, callback)
Parametry:
Zwracana wartość: brak
Pobiera szczegółowe informacje o miejscu określonym przez dany identyfikator placeId.
nearbySearch
nearbySearch(request, callback)
Parametry:
Zwracana wartość: brak
Pobiera listę miejsc w pobliżu określonej lokalizacji na podstawie słowa kluczowego lub typu. Lokalizacja musi być zawsze określona przez przekazanie parametru LatLngBounds lub parametrów location i radius. Obiekty PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnego obiektu PlaceResult. Aplikacja może uzyskać bardziej szczegółowe informacje (PlaceResult) o każdym miejscu, wysyłając żądanie informacji o miejscu z identyfikatorem PlaceResult.place_id wybranego miejsca. Obiekt PlaceSearchPagination może służyć do pobierania dodatkowych stron wyników (ma wartość null, jeśli jest to ostatnia strona wyników lub jeśli jest tylko jedna strona wyników).
textSearch
textSearch(request, callback)
Parametry:
Zwracana wartość: brak
Pobiera listę miejsc na podstawie ciągu zapytania (np. „pizza w Nowym Jorku” lub „sklepy obuwnicze w pobliżu Ottawy”). Parametry lokalizacji są opcjonalne. Gdy lokalizacja jest określona, wyniki są tylko faworyzowane pod kątem wyników w pobliżu, a nie ograniczane do miejsc w danym obszarze. Używaj textSearch, gdy chcesz wyszukiwać miejsca za pomocą dowolnego ciągu znaków i nie chcesz ograniczać wyników wyszukiwania do konkretnej 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 jeśli jest tylko jedna strona wyników).

Interfejs PlaceDetailsRequest

interfejs google.maps.places.PlaceDetailsRequest

Zapytanie o informacje o miejscu, które ma zostać wysłane do PlacesService.
placeId
Typ: string
Identyfikator miejsca, którego szczegóły są wymagane.
fields
opcjonalne
Typ: Array<string> optional
Pola, które mają być uwzględnione w odpowiedzi ze szczegółami, za które zostanie naliczona opłata. Jeśli nie określisz żadnych pól lub przekażesz ['ALL'], zostaną zwrócone wszystkie dostępne pola i zostaną za nie naliczone opłaty (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz w artykule PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek z kropkami (np. "geometry.location").
language
opcjonalne
Typ: string optional
Identyfikator języka, w którym mają być zwracane szczegóły. Zobacz listę obsługiwanych języków.
region
opcjonalne
Typ: string optional
Kod regionu użytkownika. Może to wpłynąć na to, które zdjęcia zostaną zwrócone, a także na inne elementy. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład domena 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
opcjonalne
Unikalny identyfikator używany do powiązania żądania szczegółów z sesją autouzupełniania.

Interfejs FindPlaceFromPhoneNumberRequest

interfejs google.maps.places.FindPlaceFromPhoneNumberRequest

Żądanie wyszukiwania miejsca na podstawie tekstu, które zostanie wysłane do: PlacesService.findPlaceFromPhoneNumber.
fields
Typ: Array<string>
Pola, które mają być uwzględnione w odpowiedzi i za które zostanie naliczona opłata. Jeśli podasz wartość ['ALL'], zostaną zwrócone wszystkie dostępne pola i zostaną za nie naliczone opłaty (nie zalecamy tego w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz w artykule PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek z kropkami (np. "geometry.location").
phoneNumber
Typ: string
Numer telefonu miejsca, które chcesz wyszukać. Format musi być zgodny ze standardem E.164.
language
opcjonalne
Typ: string optional
Identyfikator języka, w którym powinny być zwracane nazwy i adresy (jeśli to możliwe). Zobacz listę obsługiwanych języków.
locationBias
opcjonalne
Typ: LocationBias optional
Odchylenie używane podczas wyszukiwania miejsca. Wyniki będą faworyzować podany LocationBias, ale nie będą ograniczone tylko do niego.

Interfejs FindPlaceFromQueryRequest

interfejs google.maps.places.FindPlaceFromQueryRequest

Żądanie wyszukiwania miejsca na podstawie tekstu, które zostanie wysłane do: PlacesService.findPlaceFromQuery.
fields
Typ: Array<string>
Pola, które mają być uwzględnione w odpowiedzi i za które zostanie naliczona opłata. Jeśli podasz wartość ['ALL'], zostaną zwrócone wszystkie dostępne pola i zostaną za nie naliczone opłaty (nie zalecamy tego w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz w artykule PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek z kropkami (np. "geometry.location").
query
Typ: string
Zapytanie żądania. Może to być na przykład nazwa lub adres miejsca.
language
opcjonalne
Typ: string optional
Identyfikator języka, w którym powinny być zwracane nazwy i adresy (jeśli to możliwe). Zobacz listę obsługiwanych języków.
locationBias
opcjonalne
Typ: LocationBias optional
Odchylenie używane podczas wyszukiwania miejsca. Wyniki będą faworyzować podany LocationBias, ale nie będą ograniczone tylko do niego.

Interfejs PlaceSearchRequest

interfejs google.maps.places.PlaceSearchRequest

Zapytanie wyszukiwania miejsc, które zostanie wysłane do: PlacesService.
bounds
opcjonalne
Granice, w których mają być wyszukiwane miejsca. Jeśli zasada bounds jest skonfigurowana, zasady location i radius są ignorowane.
keyword
opcjonalne
Typ: string optional
Termin, który ma być dopasowany do wszystkich dostępnych pól, w tym m.in. nazwy, typu i adresu, a także opinii klientów i innych treści osób trzecich.
language
opcjonalne
Typ: string optional
Identyfikator języka, w którym powinny być zwracane nazwy i adresy (jeśli to możliwe). Zobacz listę obsługiwanych języków.
location
opcjonalne
Typ: LatLng|LatLngLiteral optional
Lokalizacja, wokół której chcesz wyszukać miejsca.
maxPriceLevel
opcjonalne
Typ: number optional
Ogranicza wyniki tylko do miejsc o określonym lub niższym poziomie cen. Prawidłowe wartości mieszczą się w zakresie od 0 (najtańsze) do 4 (najdroższe). Jeśli została określona, musi być równa lub większa niż minPrice .
minPriceLevel
opcjonalne
Typ: number optional
Ogranicza wyniki tylko do miejsc o określonym lub wyższym poziomie cen. Prawidłowe wartości mieszczą się w zakresie od 0 (najtańsze) do 4 (najdroższe). Jeśli podano, wartość musi być mniejsza niż maxPrice.
name
opcjonalne
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
opcjonalne
Typ: boolean optional
Ogranicza wyniki tylko do miejsc, które są obecnie otwarte.
radius
opcjonalne
Typ: number optional
Odległość od danej lokalizacji, w której mają być wyszukiwane miejsca (w metrach). Maksymalna dozwolona wartość to 50 000.
rankBy
opcjonalne
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 jest ustawiony na DISTANCE, musisz określić location, ale nie możesz określić radius ani bounds.
type
opcjonalne
Typ: string optional
Wyszukuje miejsca danego typu. Typ jest tłumaczony na język lokalny docelowej lokalizacji żądania i używany jako ciąg zapytania. Jeśli podano też zapytanie, jest ono dołączane do zlokalizowanego ciągu znaków typu. Wyniki innego typu są usuwane z odpowiedzi. Użyj tego pola, aby przeprowadzić wyszukiwanie według kategorii niezależnie od języka i regionu. Prawidłowe typy znajdziesz tutaj.

TextSearchRequest interface

interfejs google.maps.places.TextSearchRequest

Żądanie wyszukiwania tekstu, które ma zostać wysłane do PlacesService.
bounds
opcjonalne
Granice używane do faworyzowania wyników podczas wyszukiwania miejsc (opcjonalnie). Jeśli zasada bounds jest skonfigurowana, zasady location i radius są ignorowane. Wyniki nie będą ograniczone do tych, które znajdują się w tych granicach, ale wyniki w nich będą miały wyższą pozycję.
language
opcjonalne
Typ: string optional
Identyfikator języka, w którym powinny być zwracane nazwy i adresy (jeśli to możliwe). Zobacz listę obsługiwanych języków.
location
opcjonalne
Typ: LatLng|LatLngLiteral optional
Środek obszaru używanego do faworyzowania wyników podczas wyszukiwania miejsc.
query
opcjonalne
Typ: string optional
Wyszukiwane hasło w żądaniu. Może to być na przykład nazwa miejsca („Wieża Eiffla”), kategoria i nazwa lokalizacji („pizza w Nowym Jorku”) lub nazwa miejsca i uściślenie lokalizacji („Starbucks w Sydney”).
radius
opcjonalne
Typ: number optional
Promień obszaru używanego do faworyzowania wyników podczas wyszukiwania miejsc (w metrach).
region
opcjonalne
Typ: string optional
Kod regionu, który ma być faworyzowany w wynikach. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład domena 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
opcjonalne
Typ: string optional
Wyszukuje miejsca danego typu. Typ jest tłumaczony na język lokalny docelowej lokalizacji żądania i używany jako ciąg zapytania. Jeśli podano też zapytanie, jest ono dołączane do zlokalizowanego ciągu znaków typu. Wyniki innego typu są usuwane z 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

stałe google.maps.places.RankBy
biblioteka "places"

Opcje rankingu dla PlaceSearchRequest.

const {RankBy} = await google.maps.importLibrary("places");
DISTANCE Porządkuje wyniki wyszukiwania miejsc według odległości od lokalizacji.
PROMINENCE Porządkuje wyniki dotyczące miejsc według ich rozpoznawalności.

LocationBias typedef

typedef google.maps.places.LocationBias

LocationBias reprezentuje miękką granicę lub wskazówkę, której należy użyć podczas wyszukiwania miejsc. Wyniki mogą pochodzić spoza określonego obszaru. Aby użyć adresu IP bieżącego użytkownika jako wartości preferowanej, możesz podać ciąg znaków "IP_BIAS". Uwaga: jeśli używasz Circle, musisz określić środek i promień.

LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

typedef google.maps.places.LocationRestriction

Obiekt LocationRestriction reprezentuje ścisłą granicę, która ma być używana podczas wyszukiwania miejsc.

LatLngBounds|LatLngBoundsLiteral

Stałe PlacesServiceStatus

stałe google.maps.places.PlacesServiceStatus
biblioteka "places"

Stan zwracany przez PlacesService po zakończeniu wyszukiwania. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.places.PlacesServiceStatus.OK.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ PlacesServiceStatusString.

const {PlacesServiceStatus} = await google.maps.importLibrary("places");
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 udało się przetworzyć żądania PlacesService z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może zostać zrealizowane.
ZERO_RESULTS Nie znaleziono wyniku dla tego żądania.

PlaceSearchPagination interface

interfejs google.maps.places.PlaceSearchPagination

Obiekt używany do pobierania dodatkowych stron wyników dotyczących miejsc.
hasNextPage
Typ: boolean
Wskazuje, czy dostępne są dalsze wyniki. true, gdy dostępna jest dodatkowa strona wyników.
nextPage
nextPage()
Parametry: brak
Wartość zwracana: void
Pobiera następną stronę wyników. Używa tej samej funkcji wywołania zwrotnego, która została podana w pierwszym żądaniu wyszukiwania.

PlaceResult interface

interfejs google.maps.places.PlaceResult

Definiuje informacje o miejscu.
address_components
opcjonalne
Kolekcja komponentów adresu dla lokalizacji tego miejsca. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
adr_address
opcjonalne
Typ: string optional
Reprezentacja adresu miejsca w mikroformacie adr. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
aspects
opcjonalne
Typ: Array<PlaceAspectRating> optional
Oceniane aspekty tego miejsca na podstawie opinii użytkowników Google i Zagat. Oceny są wyrażone w skali od 0 do 30.
business_status
opcjonalne
Typ: BusinessStatus optional
Flaga wskazująca stan działalności 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 jest obecna w odpowiedziach na wyszukiwanie ani w odpowiedziach dotyczących szczegółów.
formatted_address
opcjonalne
Typ: string optional
Pełny adres miejsca.
formatted_phone_number
opcjonalne
Typ: string optional
Numer telefonu miejsca sformatowany zgodnie z  regionalną konwencją numeracji. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
geometry
opcjonalne
Typ: PlaceGeometry optional
Informacje o geometrii miejsca.
html_attributions
opcjonalne
Typ: Array<string> optional
Informacja o pochodzeniu danych, która ma być wyświetlana w przypadku tego wyniku dotyczącego miejsca. Dostępne html_attributions są zawsze zwracane niezależnie od tego, jakie fields zostały żądane, i muszą być wyświetlane.
icon
opcjonalne
Typ: string optional
Adres URL zasobu obrazu, który może być używany do reprezentowania kategorii tego miejsca.
icon_background_color
opcjonalne
Typ: string optional
Kolor tła do użycia z ikoną miejsca. Zobacz też PlaceResult.icon_mask_base_uri.
icon_mask_base_uri
opcjonalne
Typ: string optional
Skrócony adres URL 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
opcjonalne
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 ramach subskrypcji PlacesService.getDetails.
name
opcjonalne
Typ: string optional
Nazwa miejsca. Uwaga: w przypadku miejsc wpisanych przez użytkownika jest to nieprzetworzony tekst wpisany przez użytkownika. Zachowaj ostrożność podczas korzystania z tych danych, ponieważ nieuczciwi użytkownicy mogą próbować użyć ich jako wektora do ataków typu „wstrzykiwanie kodu” (patrz http://en.wikipedia.org/wiki/Code_injection).
opening_hours
opcjonalne
Typ: PlaceOpeningHours optional
Określa, kiedy miejsce jest otwierane lub zamykane.
permanently_closed
opcjonalne
Typ: boolean optional
Flaga wskazująca, czy miejsce jest zamknięte na stałe lub tymczasowo. Jeśli miejsce jest otwarte lub nie ma dostępnych danych, flaga nie jest obecna w odpowiedzi.
photos
opcjonalne
Typ: Array<PlacePhoto> optional
Zdjęcia tego miejsca. Kolekcja będzie zawierać maksymalnie 10 obiektów PlacePhoto.
place_id
opcjonalne
Typ: string optional
Unikalny identyfikator miejsca.
plus_code
opcjonalne
Typ: PlacePlusCode optional
Definiuje kody Open Location Code lub „plus kody” miejsca.
price_level
opcjonalne
Typ: number optional
Poziom cen w miejscu w skali od 0 do 4. Poziomy cen są interpretowane w ten sposób:
  • 0: bezpłatne
  • 1: niedrogie
  • 2: umiarkowana
  • 3: wysoka
  • 4: Bardzo drogo
rating
opcjonalne
Typ: number optional
Ocena od 1, 0 do 5, 0 na podstawie opinii użytkowników o tym miejscu.
reviews
opcjonalne
Typ: Array<PlaceReview> optional
Lista opinii o tym miejscu. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
types
opcjonalne
Typ: Array<string> optional
Tablica typów tego miejsca (np. ["political", "locality"] lub ["restaurant", "establishment"]).
url
opcjonalne
Typ: string optional
Adres URL oficjalnej strony Google dotyczącej tego miejsca. Jest to strona należąca do Google, która zawiera najlepsze dostępne informacje o miejscu. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
user_ratings_total
opcjonalne
Typ: number optional
Liczba ocen użytkowników, które wpłynęły na PlaceResult.rating tego miejsca.
utc_offset
opcjonalne
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 jest o 11 godzin wcześniejszy niż UTC, więc utc_offset będzie wynosić 660. W przypadku stref czasowych wcześniejszych niż UTC przesunięcie jest ujemne. Na przykład utc_offset dla Republiki Zielonego Przylądka to -60. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
utc_offset_minutes
opcjonalne
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 jest o 11 godzin wcześniejszy niż UTC, więc utc_offset_minutes będzie wynosić 660. W przypadku stref czasowych wcześniejszych niż UTC przesunięcie jest ujemne. Na przykład utc_offset_minutes dla Republiki Zielonego Przylądka to -60. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
vicinity
opcjonalne
Typ: string optional
Uproszczony adres miejsca, w tym nazwa ulicy, numer domu i miejscowość, ale bez województwa/stanu, kodu pocztowego i kraju. Na przykład biuro Google w Sydney w Australii ma wartość okolicy "48 Pirrama Road, Pyrmont". Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
website
opcjonalne
Typ: string optional
Oficjalna witryna tego miejsca, np. strona główna firmy. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.

PlaceAspectRating

interfejs google.maps.places.PlaceAspectRating

Definiuje informacje o aspekcie miejsca, który został oceniony przez użytkowników.
rating
Typ: number
Ocena tego aspektu. W przypadku poszczególnych opinii jest to liczba całkowita z zakresu od 0 do 3. W przypadku ocen zbiorczych miejsca jest to liczba całkowita z zakresu od 0 do 30.
type
Typ: string
Typ aspektu. Na przykład: "food", "decor", "service" lub "overall".

BusinessStatus constants

stałe google.maps.places.BusinessStatus
biblioteka "places"

Stan firmy. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ BusinessStatusString.

const {BusinessStatus} = await google.maps.importLibrary("places");
CLOSED_PERMANENTLY Firma jest zamknięta na stałe. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
CLOSED_TEMPORARILY Firma jest tymczasowo zamknięta. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
FUTURE_OPENING Firma zostanie otwarta w przyszłości. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
OPERATIONAL Firma działa, ale niekoniecznie jest teraz otwarta. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Interfejs PlaceGeometry

interfejs google.maps.places.PlaceGeometry

Definiuje informacje o geometrii miejsca.
location
opcjonalne
Typ: LatLng optional
Pozycja miejsca.
viewport
opcjonalne
Typ: LatLngBounds optional
Preferowany widoczny obszar podczas wyświetlania tego miejsca na mapie. Jeśli preferowany widoczny obszar miejsca nie jest znany, ta właściwość będzie miała wartość null. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.

Interfejs PlaceOpeningHours

interfejs google.maps.places.PlaceOpeningHours

Definiuje informacje o godzinach otwarcia miejsca.
open_now
opcjonalne
Typ: boolean optional
Czy miejsce jest obecnie otwarte.
periods
opcjonalne
Okresy otwarcia dla każdego dnia tygodnia, zaczynając od niedzieli, w porządku chronologicznym. Dni, w których miejsce jest zamknięte, nie są uwzględniane. Dostępne tylko w ramach subskrypcji PlacesService.getDetails.
weekday_text
opcjonalne
Typ: Array<string> optional
Tablica 7 ciągów znaków reprezentujących sformatowane godziny otwarcia w poszczególne dni tygodnia. Usługa Places sformatuje i zlokalizuje godziny otwarcia odpowiednio do bieżącego języka. Kolejność elementów w tej tablicy zależy od języka. W niektórych językach tydzień zaczyna się w poniedziałek, a w innych w niedzielę. Dostępne tylko w ramach subskrypcji PlacesService.getDetails. Inne wywołania mogą zwracać pustą tablicę.
isOpen
isOpen([date])
Parametry:
  • date: Date optional
Wartość zwracana: boolean|undefined
Sprawdź, czy miejsce jest teraz otwarte (gdy nie podano daty) lub czy jest otwarte w podanym 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 godzin wyjątkowych, takich jak godziny otwarcia w święta.

PlaceOpeningHoursPeriod interface

interfejs google.maps.places.PlaceOpeningHoursPeriod

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 zawsze otwarte jest reprezentowane jako okres open zawierający day z wartością 0 i time z wartością "0000", bez close.
open
Godzina otwarcia miejsca.
close
opcjonalne
Typ: PlaceOpeningHoursTime optional
Godzina zamknięcia miejsca.

Interfejs PlaceOpeningHoursTime

interfejs google.maps.places.PlaceOpeningHoursTime

Określa, kiedy miejsce jest otwierane lub zamykane.
day
Typ: number
Dni tygodnia jako liczba 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]. Będą one podawane w strefie czasowej miejsca.
minutes
Typ: number
Minuty w PlaceOpeningHoursTime.time jako liczba z zakresu [0, 59]. Będą one podawane w strefie czasowej miejsca.
time
Typ: string
Godzina w formacie 24-godzinnym „ggmm”. Wartości mieszczą się w zakresie ["0000", "2359"]. Czas będzie podawany w strefie czasowej miejsca.
nextDate
opcjonalne
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 obliczany na podstawie PlaceOpeningHoursTime.day tygodnia, PlaceOpeningHoursTime.time i PlaceResult.utc_offset_minutes. Jeśli PlaceResult.utc_offset_minutes to undefined, nextDate będzie undefined.

Interfejs PlacePlusCode

interfejs google.maps.places.PlacePlusCode

Definiuje kody Open Location Code lub „plus code” dla miejsca. Kodów Plus można używać zamiast adresów ulic w miejscach, gdzie nie ma adresów (gdzie budynki nie są ponumerowane lub ulice nie mają nazw).
global_code
Typ: string
Plus code z obszarem o wymiarach 1/8000 stopnia na 1/8000 stopnia. Na przykład: "8FVC9G8F+5W".
compound_code
opcjonalne
Typ: string optional
Kod Plus Code z obszarem o wymiarach 1/8000 stopnia na 1/8000 stopnia, w którym pierwsze 4 znaki (kod obszaru) są usunięte i zastąpione opisem lokalizacji. Na przykład: "9G8F+5W Zurich, Switzerland". Jeśli nie można znaleźć odpowiedniej miejscowości, aby skrócić kod, to pole jest pomijane.

Interfejs PlacePhoto

interfejs google.maps.places.PlacePhoto

Reprezentuje element zdjęcia miejsca.
height
Typ: number
Wysokość zdjęcia w pikselach.
html_attributions
Typ: Array<string>
Informacja o pochodzeniu danych, która ma być wyświetlana w przypadku tego zdjęcia.
width
Typ: number
Szerokość zdjęcia w pikselach.
getUrl
getUrl([opts])
Parametry:
Wartość zwracana: string
Zwraca adres URL obrazu odpowiadający określonym opcjom.

Interfejs PhotoOptions

interfejs google.maps.places.PhotoOptions

Definiuje opcje prośby o zdjęcie.
maxHeight
opcjonalne
Typ: number optional
Maksymalna wysokość zwracanego obrazu w pikselach.
maxWidth
opcjonalne
Typ: number optional
Maksymalna szerokość zwracanego obrazu w pikselach.

PlaceReview

interfejs google.maps.places.PlaceReview

Reprezentuje pojedynczą opinię o miejscu.
author_name
Typ: string
Imię i nazwisko osoby, która dodała opinię.
language
Typ: string
Kod języka IETF wskazujący język, w którym napisano opinię. Pamiętaj, że ten kod zawiera tylko główny tag języka bez tagu dodatkowego 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 autora opinii.
relative_time_description
Typ: string
Ciąg znaków sformatowanego czasu, który wyraża czas opublikowania opinii względem bieżącego czasu w formie odpowiedniej dla języka i kraju. Na przykład "a month ago".
text
Typ: string
Treść opinii.
time
Typ: number
Sygnatura czasowa opinii wyrażona w sekundach od początku epoki.
aspects
opcjonalne
Typ: Array<PlaceAspectRating> optional
Aspekty oceniane w opinii. Oceny w skali od 0 do 3.
author_url
opcjonalne
Typ: string optional
URL profilu osoby oceniającej. Jeśli profil recenzenta jest niedostępny, będzie to undefined.
rating
opcjonalne
Typ: number optional
Ocena w opinii, liczba od 1,0 do 5,0 (włącznie).