Package google.maps.places.v1

Landmark

Lista pobliskich punktów orientacyjnych posortowana według odległości. Najbardziej rozpoznawalne i najbliższe punkty orientacyjne są wyświetlane na początku listy.

Area

Lista zawierająca obszary, które obejmują lub sąsiadują z danym obszarem, posortowana według rankingu. Najbardziej rozpoznawalne i precyzyjne obszary są wyświetlane jako pierwsze.

string

Nazwa zasobu obszaru.

string

Identyfikator miejsca obszaru.

LocalizedText

Wyświetlana nazwa obszaru.

Containment

Określa relację przestrzenną między lokalizacją docelową a obszarem.

string

Nazwa zasobu punktu orientacyjnego.

string

Identyfikator miejsca punktu orientacyjnego.

LocalizedText

Wyświetlana nazwa punktu orientacyjnego.

string

Zestaw tagów typu dla tego punktu orientacyjnego. Pełną listę możliwych wartości znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

SpatialRelationship

Określa relację przestrzenną między lokalizacją docelową a punktem orientacyjnym.

float

Odległość w metrach w linii prostej między punktem środkowym celu a punktem środkowym punktu orientacyjnego. W niektórych sytuacjach ta wartość może być większa niż travel_distance_meters.

float

Odległość podróży w metrach wzdłuż sieci dróg od miejsca docelowego do punktu orientacyjnego, jeśli jest znana. Ta wartość nie uwzględnia środka transportu, np. chodzenia, jazdy samochodem czy rowerem.

string

Imię i nazwisko autora Photo lub Review.

string

Identyfikator URI autora Photo lub Review.

string

Identyfikator URI zdjęcia profilowego autora Photo lub Review.

string

Wymagane. Ciąg tekstowy, w którym ma zostać przeprowadzone wyszukiwanie.

LocationBias

Opcjonalnie. Przesuwanie wyników w kierunku określonej lokalizacji.

Należy ustawić maksymalnie jedną z tych wartości: location_bias lub location_restriction. Jeśli żadna z tych opcji nie zostanie ustawiona, wyniki będą obciążone adresem IP, co oznacza, że adres IP zostanie przypisany do niedokładnej lokalizacji i użyty jako sygnał obciążający.

LocationRestriction

Opcjonalnie. Ogranicz wyniki do określonej lokalizacji.

Należy ustawić maksymalnie jedną z tych wartości: location_bias lub location_restriction. Jeśli żadna z tych opcji nie zostanie ustawiona, wyniki będą obciążone adresem IP, co oznacza, że adres IP zostanie przypisany do niedokładnej lokalizacji i użyty jako sygnał obciążający.

string

Opcjonalnie. Zawiera podstawowy typ miejsca (np. „restaurant” lub „gas_station”) w sekcji Typy miejsc (https://developers.google.com/maps/documentation/places/web-service/place-types) lub tylko (regions), lub tylko (cities). Miejsce jest zwracane tylko wtedy, gdy jego główny typ znajduje się na tej liście. Możesz określić maksymalnie 5 wartości. Jeśli nie określisz żadnych typów, zwracane będą wszystkie typy miejsc.

string

Opcjonalnie. Uwzględniaj tylko wyniki z określonych regionów, podanych jako maksymalnie 15 dwuznakowych kodów regionów CLDR. Pusty zbiór nie ograniczy wyników. Jeśli ustawisz zarówno location_restriction, jak i included_region_codes, wyniki będą znajdować się w obszarze przecięcia.

string

Opcjonalnie. Język, w którym mają być zwracane wyniki. Domyślna wartość to en-US. Wyniki mogą być w różnych językach, jeśli język użyty w input różni się od języka language_code lub jeśli zwrócone miejsce nie ma tłumaczenia z języka lokalnego na język language_code.

string

Opcjonalnie. Kod regionu określony jako dwuznakowy kod regionu CLDR. Ma to wpływ na formatowanie adresu i ranking wyników, a także może wpływać na to, jakie wyniki są zwracane. Nie ogranicza to wyników do określonego regionu. Aby ograniczyć wyniki do regionu, użyj symbolu region_code_restriction.

LatLng

Opcjonalnie. Punkt początkowy, od którego należy obliczyć odległość geodezyjną do miejsca docelowego (zwracany jako distance_meters). Jeśli ta wartość zostanie pominięta, odległość geodezyjna nie zostanie zwrócona.

int32

Opcjonalnie. Przesunięcie znaku Unicode liczone od zera, wynoszące input, wskazujące pozycję kursora w input. Pozycja kursora może wpływać na zwracane prognozy.

Jeśli to pole jest puste, domyślnie przyjmuje długość input.

bool

Opcjonalnie. Jeśli wartość to „true”, odpowiedź będzie zawierać zarówno prognozy dotyczące miejsca, jak i prognozy dotyczące zapytania. W przeciwnym razie odpowiedź będzie zawierać tylko prognozy dotyczące miejsc.

string

Opcjonalnie. Ciąg znaków, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny ciąg znaków base64, który może zawierać maksymalnie 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja rozpoczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy się, gdy wybierze miejsce i wykona wywołanie informacji o miejscu lub Weryfikacji adresów. Każda sesja może zawierać wiele zapytań, po których następuje 1 żądanie informacji o miejscu lub weryfikacji adresu. Dane logowania używane w każdym żądaniu w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr session_token zostanie pominięty lub jeśli użyjesz ponownie tokena sesji, sesja zostanie obciążona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).

Zalecamy stosowanie tych wytycznych:

• Używaj tokenów sesji we wszystkich wywołaniach autouzupełniania miejsc.
• Generuj nowy token dla każdej sesji. Zalecamy używanie identyfikatora UUID w wersji 4.
• Upewnij się, że dane logowania używane we wszystkich żądaniach autouzupełniania miejsc, szczegółów miejsca i weryfikacji adresu w ramach sesji należą do tego samego projektu w Cloud Console.
• Pamiętaj, aby przekazywać unikalny token sesji dla każdej nowej sesji. Używanie tego samego tokena w przypadku więcej niż jednej sesji spowoduje, że każde żądanie będzie rozliczane osobno.

bool

Opcjonalnie. Uwzględnij firmy działające tylko na określonym obszarze, jeśli pole ma wartość true. Firma działająca tylko na określonym obszarze to firma, która świadczy usługi na miejscu u klienta lub samodzielnie dostarcza produkty odbiorcom, ale nie obsługuje klientów pod swoim adresem. Mogą to być hydraulicy lub firmy świadczące usługi sprzątania. Nie mają one fizycznego adresu ani lokalizacji w Mapach Google. W przypadku tych firm Miejsca nie będą zwracać pól, w tym location, plus_code i innych pól związanych z lokalizacją.

bool

Opcjonalnie. Jeśli tak, uwzględnij firmy, które nie są jeszcze otwarte, ale zostaną otwarte w przyszłości.

Viewport

Obszar widoczny zdefiniowany przez północno-wschodni i południowo-zachodni róg.

Circle

Okrąg zdefiniowany przez punkt środkowy i promień.

Viewport

Obszar widoczny zdefiniowany przez północno-wschodni i południowo-zachodni róg.

Circle

Okrąg zdefiniowany przez punkt środkowy i promień.

Suggestion

Zawiera listę sugestii uporządkowanych w kolejności malejącej według trafności.

PlacePrediction

Prognoza dla miejsca.

QueryPrediction

Prognoza dotycząca zapytania.

string

Tekst, który można wykorzystać w niezmienionej formie lub sformatować za pomocą matches.

StringRange

Lista zakresów ciągów tekstowych określających, gdzie w text wystąpiło dopasowanie żądania wejściowego. Zakresy można stosować do formatowania określonych części text. Podciągi mogą nie być dokładnymi dopasowaniami do input, jeśli dopasowanie zostało określone na podstawie kryteriów innych niż dopasowanie ciągów znaków (np. korekty pisowni lub transliteracji).

Te wartości to przesunięcia znaków Unicode względem znaku text. Zakresy są uporządkowane według rosnących wartości przesunięcia.

string

Nazwa zasobu sugerowanego miejsca. Tej nazwy można używać w innych interfejsach API, które akceptują nazwy miejsc.

string

Unikalny identyfikator sugerowanego miejsca. Ten identyfikator może być używany w innych interfejsach API, które akceptują identyfikatory miejsc.

FormattableText

Zawiera zrozumiałą dla człowieka nazwę zwróconego wyniku. W przypadku wyników dotyczących placówek jest to zwykle nazwa i adres firmy.

text jest zalecany dla programistów, którzy chcą wyświetlać pojedynczy element interfejsu. Deweloperzy, którzy chcą wyświetlać 2 osobne, ale powiązane elementy interfejsu, mogą zamiast tego użyć structured_format. Są to 2 różne sposoby przedstawiania prognozy dotyczącej miejsca. Użytkownicy nie powinni próbować analizować structured_format w text ani na odwrót.

Ten tekst może się różnić od display_name zwróconego przez GetPlace.

Może być w różnych językach, jeśli input i language_code są w różnych językach lub jeśli miejsce nie ma tłumaczenia z języka lokalnego na language_code.

StructuredFormat

Zestawienie podpowiedzi Miejsc na tekst główny zawierający nazwę Miejsca i tekst dodatkowy zawierający dodatkowe cechy rozróżniające (np. miasto lub region).

structured_format jest zalecany dla deweloperów, którzy chcą wyświetlać 2 osobne, ale powiązane ze sobą elementy interfejsu. Deweloperzy, którzy chcą wyświetlić jeden element interfejsu, mogą zamiast tego użyć text. Są to 2 różne sposoby przedstawiania prognozy dotyczącej miejsca. Użytkownicy nie powinni próbować analizować structured_format w text ani na odwrót.

string

Lista typów, które odnoszą się do tego miejsca, z tabeli A lub tabeli B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

Typ to kategoria miejsca. Miejsca o udostępnionych typach będą miały podobne cechy.

int32

Długość geodezyjna w metrach od origin, jeśli określono origin. Niektóre prognozy, np. trasy, mogą nie wypełniać tego pola.

FormattableText

Przewidywany tekst. Ten tekst nie reprezentuje miejsca, ale zapytanie tekstowe, które można wykorzystać w punkcie końcowym wyszukiwania (np. w wyszukiwaniu tekstowym).

text jest zalecany dla programistów, którzy chcą wyświetlać pojedynczy element interfejsu. Deweloperzy, którzy chcą wyświetlać 2 osobne, ale powiązane elementy interfejsu, mogą zamiast tego użyć structured_format. Są to 2 różne sposoby przedstawiania prognozy zapytania. Użytkownicy nie powinni próbować analizować structured_format w text ani na odwrót.

Może być w różnych językach, jeśli prośba input i language_code są w różnych językach lub jeśli część zapytania nie ma tłumaczenia z języka lokalnego na język language_code.

StructuredFormat

Podział podpowiedzi zapytania na tekst główny zawierający zapytanie i tekst dodatkowy zawierający dodatkowe funkcje rozróżniające (np. miasto lub region).

structured_format jest zalecany dla deweloperów, którzy chcą wyświetlać 2 osobne, ale powiązane ze sobą elementy interfejsu. Deweloperzy, którzy chcą wyświetlić jeden element interfejsu, mogą zamiast tego użyć text. Są to 2 różne sposoby przedstawiania prognozy zapytania. Użytkownicy nie powinni próbować analizować structured_format w text ani na odwrót.

int32

Indeks pierwszego znaku Unicode w ciągu (włącznie), liczony od zera.

int32

Indeks ostatniego znaku Unicode (wykluczając najwyższą wartość).

FormattableText

Reprezentuje nazwę miejsca lub zapytania.

FormattableText

Reprezentuje dodatkowe cechy rozróżniające (np. miasto lub region), które pozwalają dokładniej zidentyfikować miejsce lub doprecyzować zapytanie.

LatLng

Wymagane. Szerokość i długość geograficzna środka.

Zakres szerokości geograficznej musi mieścić się w przedziale [-90,0, 90,0]. Zakres długości geograficznej musi mieścić się w przedziale [-180,0, 180,0].

double

Wymagane. Promień mierzony w metrach. Promień musi mieścić się w zakresie [0,0, 50000,0].

LocalizedText

treści związane z tematem;

string

Lista nazw zasobów miejsc, do których się odwołujesz. Tej nazwy można używać w innych interfejsach API, które akceptują nazwy zasobów Miejsca.

Review

Lista opinii o tym miejscu, powiązanych z zapytaniem o miejsce.

Photo

Informacje (w tym odniesienia) o zdjęciach tego miejsca, które są powiązane z zapytaniem o miejsce.

Justification

uzasadnienia dotyczące miejsca;

ReviewJustification

BusinessAvailabilityAttributesJustification

bool

Czy miejsce oferuje dania na wynos.

bool

Czy to miejsce oferuje dostawę.

bool

Czy w tym miejscu można zjeść posiłek.

HighlightedText

Review

Opinia, z której pochodzi podświetlony tekst.

string

HighlightedTextRange

Lista zakresów zaznaczonego tekstu.

int32

int32

int32

Liczba złączy na tej stacji. Niektóre porty mogą mieć wiele złączy, ale mogą ładować tylko 1 samochód naraz. Dlatego liczba złączy może być większa niż łączna liczba samochodów, które można ładować jednocześnie.

ConnectorAggregation

Lista agregacji złączy ładowania pojazdów elektrycznych, które zawierają złącza tego samego typu i o tej samej szybkości ładowania.

EVConnectorType

Typ łącznika tej agregacji.

double

Statyczna maksymalna szybkość ładowania w kW każdego złącza w agregacji.

int32

Liczba łączników w tej agregacji.

Timestamp

Sygnatura czasowa ostatniej aktualizacji informacji o dostępności złącza w tej agregacji.

int32

Liczba dostępnych obecnie łączników w tej agregacji.

int32

Liczba złączy w tej agregacji, które są obecnie niedostępne.

FuelPrice

Ostatnia znana cena każdego rodzaju paliwa dostępnego na tej stacji. Każdy rodzaj paliwa dostępny na stacji ma swój wpis. Kolejność nie ma znaczenia.

FuelType

Rodzaj paliwa.

Money

Cena paliwa.

Timestamp

Czas ostatniej aktualizacji ceny paliwa.

string

Wymagane. Nazwa zasobu zdjęcia w formacie: places/{place_id}/photos/{photo_reference}/media.

Nazwa zasobu zdjęcia zwracana w polu photos.name obiektu Place ma format places/{place_id}/photos/{photo_reference}. Aby uzyskać nazwę zasobu multimediów zdjęcia, musisz dodać /media na końcu zasobu zdjęcia.

int32

Opcjonalnie. Określa maksymalną żądaną szerokość obrazu w pikselach. Jeśli obraz jest mniejszy niż podane wartości, zostanie zwrócony oryginalny obraz. Jeśli obraz jest większy w jednym z wymiarów, zostanie przeskalowany tak, aby pasował do mniejszego z nich, z zachowaniem pierwotnego współczynnika proporcji. Właściwości max_height_px i max_width_px akceptują liczbę całkowitą z zakresu od 1 do 4800 włącznie. Jeśli wartość nie mieści się w dozwolonym zakresie, zwracany jest błąd INVALID_ARGUMENT.

Musisz podać co najmniej jedną z tych wartości: max_height_px lub max_width_px. Jeśli nie określono ani max_height_px, ani max_width_px, zwracany jest błąd INVALID_ARGUMENT.

int32

Opcjonalnie. Określa maksymalną oczekiwaną wysokość obrazu w pikselach. Jeśli obraz jest mniejszy niż podane wartości, zostanie zwrócony oryginalny obraz. Jeśli obraz jest większy w jednym z wymiarów, zostanie przeskalowany tak, aby pasował do mniejszego z nich, z zachowaniem pierwotnego współczynnika proporcji. Właściwości max_height_px i max_width_px akceptują liczbę całkowitą z zakresu od 1 do 4800 włącznie. Jeśli wartość nie mieści się w dozwolonym zakresie, zwracany jest błąd INVALID_ARGUMENT.

Musisz podać co najmniej jedną z tych wartości: max_height_px lub max_width_px. Jeśli nie określono ani max_height_px, ani max_width_px, zwracany jest błąd INVALID_ARGUMENT.

bool

Opcjonalnie. Jeśli ta opcja jest ustawiona, pomiń domyślne przekierowanie HTTP i wyrenderuj odpowiedź w formacie tekstowym (np. w formacie JSON w przypadku HTTP). Jeśli nie jest ustawiony, zostanie wydane przekierowanie HTTP, aby przekierować połączenie do multimediów z obrazem. Ta opcja jest ignorowana w przypadku żądań innych niż HTTP.

string

Wymagane. Nazwa zasobu miejsca w formacie places/{place_id}.

string

Opcjonalnie. Informacje o miejscu będą wyświetlane w preferowanym języku, jeśli jest on dostępny.

Aktualna lista obsługiwanych języków: https://developers.google.com/maps/faq#languagesupport.

string

Opcjonalnie. Kod Unicode kraju lub regionu (CLDR) lokalizacji, z której pochodzi żądanie. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie, jeśli jest dostępna. W zależności od obowiązujących przepisów parametr może wpływać na wyniki. Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Pamiętaj, że 3-cyfrowe kody regionów nie są obecnie obsługiwane.

string

Opcjonalnie. Ciąg znaków, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny ciąg znaków base64, który może zawierać maksymalnie 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja rozpoczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy się, gdy wybierze miejsce i wykona wywołanie informacji o miejscu lub Weryfikacji adresów. Każda sesja może zawierać wiele zapytań, po których następuje 1 żądanie informacji o miejscu lub weryfikacji adresu. Dane logowania używane w każdym żądaniu w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr session_token zostanie pominięty lub jeśli użyjesz ponownie tokena sesji, sesja zostanie obciążona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).

Zalecamy stosowanie tych wytycznych:

• Używaj tokenów sesji we wszystkich wywołaniach autouzupełniania miejsc.
• Generuj nowy token dla każdej sesji. Zalecamy używanie identyfikatora UUID w wersji 4.
• Upewnij się, że dane logowania używane we wszystkich żądaniach autouzupełniania miejsc, szczegółów miejsca i weryfikacji adresu w ramach sesji należą do tego samego projektu w Cloud Console.
• Pamiętaj, aby przekazywać unikalny token sesji dla każdej nowej sesji. Używanie tego samego tokena w przypadku więcej niż jednej sesji spowoduje, że każde żądanie będzie rozliczane osobno.

string

Identyfikator. Odwołanie do tego zdjęcia miejsca, które może być użyte do ponownego wyszukania tego zdjęcia (nazywane też nazwą „zasobu” API: places/{place_id}/photos/{photo}).

int32

Maksymalna dostępna szerokość (w pikselach).

int32

Maksymalna dostępna wysokość (w pikselach).

AuthorAttribution

Autorzy tego zdjęcia.

string

Link, za pomocą którego użytkownicy mogą zgłosić problem ze zdjęciem.

string

link do wyświetlenia zdjęcia w Mapach Google;

string

Nazwa zasobu zdjęcia w formacie: places/{place_id}/photos/{photo_reference}/media.

string

Krótkotrwały identyfikator URI, którego można użyć do renderowania zdjęcia.

string

Nazwa zasobu tego miejsca w formacie places/{place_id}. Można go użyć do wyszukania miejsca.

string

Unikalny identyfikator miejsca.

LocalizedText

Zlokalizowana nazwa miejsca, która może być krótkim opisem zrozumiałym dla użytkowników. np. „Google Sydney”, „Starbucks”, „Pyrmont” itp.

string

Zestaw tagów typu dla tego wyniku. Na przykład „political” i „locality”. Pełną listę możliwych wartości znajdziesz w tabelach A i B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

string

Główny typ danego wyniku. Ten typ musi być jednym z typów obsługiwanych przez interfejs Places API. Na przykład „restauracja”, „kawiarnia”, „lotnisko” itp. Miejsce może mieć tylko jeden typ podstawowy. Pełną listę możliwych wartości znajdziesz w tabelach A i B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types. Główny typ może być niedostępny, jeśli nie jest obsługiwany. Gdy typ podstawowy jest obecny, zawsze jest jednym z typów w polu types.

LocalizedText

Wyświetlana nazwa typu podstawowego, zlokalizowana w języku żądania (w stosownych przypadkach). Pełną listę możliwych wartości znajdziesz w tabelach A i B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types. Główny typ może być niedostępny, jeśli nie jest obsługiwany.

LocalizedText

Etykieta typu miejsca w Mapach Google, przetłumaczona na język żądania, jeśli to możliwe, np. „Restauracja”, „Kawiarnia”, „Lotnisko” itp. Etykieta typu może różnić się od nazwy wyświetlanej typu podstawowego i może nie być obsługiwanym typem w tabeli typów miejsc w interfejsie Places API.

string

Zrozumiały dla człowieka numer telefonu miejsca w formacie krajowym.

string

Numer telefonu miejsca w formacie międzynarodowym, który jest zrozumiały dla człowieka.

string

Pełny, zrozumiały dla człowieka adres tego miejsca.

string

Krótki, zrozumiały dla człowieka adres tego miejsca.

PostalAddress

Adres w formacie adresu pocztowego.

AddressComponent

Powtarzane komponenty dla każdego poziomu lokalizacji. Zwróć uwagę na te fakty dotyczące tablicy address_components[]: – Tablica komponentów adresu może zawierać więcej komponentów niż sformatowany adres. – Tablica nie musi zawierać wszystkich jednostek politycznych, które zawierają adres, z wyjątkiem tych, które są uwzględnione w polu formatted_address. Aby pobrać wszystkie jednostki administracyjne, które zawierają określony adres, użyj geokodowania zwrotnego, przekazując szerokość i długość geograficzną adresu jako parametr żądania. – Format odpowiedzi nie musi być taki sam w przypadku różnych żądań. W szczególności liczba elementów adresu zależy od żądanego adresu i może się zmieniać z czasem w przypadku tego samego adresu. Komponent może zmienić pozycję w tablicy. Typ komponentu może się zmienić. W późniejszej odpowiedzi może brakować określonego komponentu.

PlusCode

Kod plus lokalizacji miejsca (szerokość i długość geograficzna).

LatLng

Położenie tego miejsca.

Viewport

Widoczny obszar odpowiedni do wyświetlania miejsca na mapie o średniej wielkości. Ten obszar widoku nie powinien być traktowany jako fizyczna granica ani obszar obsługi firmy.

double

Ocena od 1,0 do 5,0 na podstawie opinii użytkowników o tym miejscu.

string

Adres URL z dodatkowymi informacjami o tym miejscu.

string

Autorytatywna witryna tego miejsca, np. strona główna firmy. Pamiętaj, że w przypadku miejsc należących do sieci (np. sklepu IKEA) będzie to zwykle witryna konkretnego sklepu, a nie całej sieci.

Review

Lista opinii o tym miejscu posortowanych według trafności. Możesz uzyskać maksymalnie 5 opinii.

Photo

Informacje (w tym odnośniki) o zdjęciach tego miejsca. Można zwrócić maksymalnie 10 zdjęć.

string

Adres miejsca w mikroformacie adr: http://microformats.org/wiki/adr.

BusinessStatus

Stan firmy w przypadku danego miejsca.

Date

Data otwarcia tego miejsca w przyszłości. To pole jest wypełniane tylko wtedy, gdy stan firmy to FUTURE_OPENING.

PriceLevel

Poziom cen w miejscu.

Attribution

Zestaw dostawców danych, którzy muszą być wyświetlani z tym wynikiem.

string

Skrócony adres URL maski ikony. Użytkownik może uzyskać dostęp do ikony innego typu, dodając na końcu sufiks typu (np. „.svg” lub „.png”).

string

Kolor tła elementu icon_mask w formacie szesnastkowym, np. #909CE1.

OpeningHours

Godziny pracy na najbliższe 7 dni (w tym na dziś) z uwzględnieniem niestandardowych godzin otwarcia. Okres rozpoczyna się o północy w dniu przesłania prośby i kończy o 23:59 sześć dni później. Jeśli rzeczywiste godziny otwarcia wykraczają poza ten zakres, zostaną skrócone. Jeśli na przykład miejsce jest otwarte od 22:00 wczoraj do 6:00 dzisiaj, godziny otwarcia zostaną skrócone do 0:00 dzisiaj do 6:00 dzisiaj. To pole zawiera pole podrzędne special_days wszystkich godzin otwarcia ustawionych na daty, w których obowiązują niestandardowe godziny otwarcia.

OpeningHours

Standardowe godziny otwarcia to godziny otwarcia miejsca w typowym harmonogramie. Pamiętaj, że jeśli miejsce jest zawsze otwarte (24 godziny na dobę), pole close nie zostanie ustawione. Klienci mogą zakładać, że „zawsze otwarte” (24 godziny) jest reprezentowane jako okres open zawierający day o wartości 0, hour o wartości 0 i minute o wartości 0.

OpeningHours

Zawiera tablicę wpisów na najbliższe 7 dni, w tym informacje o dodatkowych godzinach otwarcia firmy. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może określić godziny otwarcia dla klientów zmotoryzowanych lub godziny dostawy jako godziny dodatkowe. To pole wypełnia pole podrzędne typu, które korzysta z wstępnie zdefiniowanej listy typów godzin otwarcia (np. DRIVE_THROUGH, PICKUP lub TAKEOUT) na podstawie typów miejsca. To pole zawiera pole podrzędne special_days wszystkich godzin otwarcia ustawionych na daty, w których obowiązują niestandardowe godziny otwarcia.

OpeningHours

Zawiera tablicę wpisów z informacjami o regularnych dodatkowych godzinach otwarcia firmy. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może określić godziny otwarcia dla klientów zmotoryzowanych lub godziny dostawy jako godziny dodatkowe. To pole wypełnia pole podrzędne typu, które korzysta z wstępnie zdefiniowanej listy typów godzin otwarcia (np. DRIVE_THROUGH, PICKUP lub TAKEOUT) na podstawie typów miejsca.

TimeZone

Strefa czasowa z bazy danych stref czasowych IANA. Na przykład „Ameryka/Nowy_Jork”.

LocalizedText

Zawiera podsumowanie informacji o miejscu. Podsumowanie składa się z tekstowego opisu, a w stosownych przypadkach zawiera też kod języka. Tekst podsumowania musi być wyświetlany w niezmienionej formie i nie można go modyfikować ani zmieniać.

PaymentOptions

Opcje płatności akceptowane w danym miejscu. Jeśli dane opcji płatności są niedostępne, pole opcji płatności zostanie wyczyszczone.

ParkingOptions

Opcje parkowania oferowane przez to miejsce.

SubDestination

Lista podrzędnych miejsc docelowych powiązanych z miejscem.

FuelOptions

Najnowsze informacje o rodzajach paliwa na stacji. Te informacje są regularnie aktualizowane.

EVChargeOptions

Informacje o opcjach ładowania pojazdów elektrycznych.

GenerativeSummary

podsumowanie miejsca wygenerowane przez AI.

ContainingPlace

Lista miejsc, w których znajduje się bieżące miejsce.

AddressDescriptor

Opis adresu miejsca. Deskryptory adresów zawierają dodatkowe informacje, które pomagają opisać lokalizację za pomocą punktów orientacyjnych i obszarów. Informacje o zasięgu regionalnym deskryptorów adresów znajdziesz na stronie https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.

GoogleMapsLinks

Linki do uruchamiania różnych działań w Mapach Google.

PriceRange

Przedział cenowy powiązany z miejscem.

ReviewSummary

Podsumowanie miejsca wygenerowane przez AI na podstawie opinii użytkowników.

EvChargeAmenitySummary

Podsumowanie udogodnień w pobliżu stacji ładowania EV.

NeighborhoodSummary

Podsumowanie ciekawych miejsc w pobliżu.

ConsumerAlert

Komunikat ostrzegawczy dla konsumentów dotyczący miejsca, gdy wykryjemy podejrzaną aktywność związaną z opiniami dotyczącymi firmy lub jeśli firma narusza nasze zasady.

string

Jeśli to miejsce jest zamknięte na stałe i zostało przeniesione do nowego miejsca, to pole zawiera nazwę zasobu nowego miejsca w formacie places/{place_id}. Jeśli to miejsce zostało przeniesione kilka razy, to pole będzie zawierać informacje o pierwszym przeniesieniu. Jeśli to miejsce nie zostało przeniesione, to pole nie będzie wypełnione.

string

Jeśli to miejsce jest zamknięte na stałe i zostało przeniesione do nowego miejsca, to pole zawiera identyfikator nowego miejsca. Jeśli to miejsce zostało przeniesione wiele razy, to pole będzie zawierać informacje o pierwszym przeniesieniu. Jeśli to miejsce nie zostało przeniesione, to pole nie będzie wypełnione.

TransitStation

Informacje o stacji transportu publicznego w danym miejscu.

int32

Łączna liczba opinii o tym miejscu (z tekstem lub bez).

bool

Określa, czy firma obsługuje zamówienia na wynos.

bool

Określa, czy firma obsługuje dostawę.

bool

Określa, czy firma oferuje miejsca do siedzenia wewnątrz czy na zewnątrz.

bool

Określa, czy firma obsługuje odbiór na zewnątrz.

bool

Określa, czy w danym miejscu można dokonać rezerwacji.

bool

Określa, czy w danym miejscu serwowane są śniadania.

bool

Określa, czy w danym miejscu można zjeść obiad.

bool

Określa, czy w danym miejscu można zjeść kolację.

bool

Określa, czy w danym miejscu można napić się piwa.

bool

Określa, czy w danym miejscu serwowane jest wino.

bool

Określa, czy w tym miejscu można zjeść brunch.

bool

Określa, czy w danym miejscu można zjeść dania wegetariańskie.

int32

Liczba minut, o którą strefa czasowa tego miejsca jest obecnie przesunięta względem czasu UTC. Jest on wyrażony w minutach, aby obsługiwać strefy czasowe, które są przesunięte o ułamki godziny, np. X godzin i 15 minut.

bool

Dostępne są miejsca do siedzenia na świeżym powietrzu.

bool

W tym miejscu można posłuchać muzyki na żywo.

bool

Miejsce ma menu dla dzieci.

bool

W tym miejscu serwowane są koktajle.

bool

Miejsce serwuje desery.

bool

Miejsce serwuje kawę.

bool

Miejsce jest odpowiednie dla dzieci.

bool

Można wejść z psem.

bool

Miejsce ma toaletę.

bool

Miejsce jest przystosowane do obsługi grup.

bool

Miejsce nadaje się do oglądania sportu.

AccessibilityOptions

Informacje o ułatwieniach dostępu w danym miejscu.

bool

Wskazuje, czy miejsce jest firmą działającą w ramach obszaru usług. Firma działająca tylko na określonym obszarze to firma, która świadczy usługi na miejscu u klienta lub samodzielnie dostarcza produkty odbiorcom, ale nie obsługuje klientów pod swoim adresem. Mogą to być hydraulicy lub firmy świadczące usługi sprzątania. Te firmy mogą nie mieć fizycznego adresu ani lokalizacji w Mapach Google.

bool

Miejsce ma parking dostępny dla osób na wózkach.

bool

Miejsca mają wejście dla niepełnosprawnych.

bool

Miejsce ma toaletę dostępną dla osób na wózkach.

bool

Miejsce ma miejsca dla osób na wózkach.

string

Pełny tekst opisu lub nazwa komponentu adresu. Na przykład komponent adresu dla kraju Australia może mieć wartość long_name „Australia”.

string

Skrócona nazwa tekstowa komponentu adresu, jeśli jest dostępna. Na przykład komponent adresu dla Australii może mieć wartość short_name „AU”.

string

Tablica wskazująca typy komponentu adresu.

string

Język używany do formatowania tego komponentu w notacji CLDR.

string

Nazwa dostawcy danych o miejscu.

string

Identyfikator URI dostawcy danych o miejscu.

string

Omówienie alertu konsumenckiego.

Details

Szczegóły komunikatu alertu konsumenckiego.

string

Kod języka komunikatu z ostrzeżeniem dla konsumentów. Jest to kod języka BCP 47.

string

Tytuł, który ma być wyświetlany razem z opisem.

string

Opis komunikatu alertu konsumenckiego.

Link

Link, który ma się wyświetlać razem z opisem, aby dostarczać więcej informacji.

string

Tytuł, który ma być wyświetlany w przypadku linku.

string

Adres URI linku.

string

Nazwa zasobu miejsca, w którym znajduje się to miejsce.

string

Identyfikator miejsca, w którym znajduje się to miejsce.

ContentBlock

Omówienie dostępnych udogodnień. Jest to gwarantowane.

ContentBlock

Podsumowanie opcji kawiarni w pobliżu.

ContentBlock

Podsumowanie restauracji w pobliżu.

ContentBlock

Podsumowanie sklepów w pobliżu.

string

Link, za pomocą którego użytkownicy mogą zgłosić problem z podsumowaniem.

LocalizedText

Informacja o wykorzystaniu AI „Podsumowano za pomocą Gemini” (i jej wersje w innych językach). Jeśli to możliwe, będzie on dostępny w języku określonym w żądaniu.

LocalizedText

Przegląd miejsca.

string

Link, za pomocą którego użytkownicy mogą zgłosić problem ze streszczeniem.

LocalizedText

Informacja o wykorzystaniu AI „Podsumowano za pomocą Gemini” (i jej wersje w innych językach). Jeśli to możliwe, będzie on dostępny w języku określonym w żądaniu.

string

Link do wskazówek dojazdu do miejsca. Link zawiera tylko miejsce docelowe i korzysta z domyślnego trybu podróży DRIVE.

string

Link do wyświetlenia tego miejsca.

string

Link do napisania opinii o tym miejscu w Mapach Google.

string

link do opinii o tym miejscu w Mapach Google;

string

link do zdjęć tego miejsca w Mapach Google;

ContentBlock

podsumowanie ogólne dotyczące okolicy,

ContentBlock

Szczegółowy opis okolicy.

string

Link, za pomocą którego użytkownicy mogą zgłosić problem z podsumowaniem.

LocalizedText

Informacja o wykorzystaniu AI „Podsumowano za pomocą Gemini” (i jej wersje w innych językach). Jeśli to możliwe, będzie on dostępny w języku określonym w żądaniu.

Period

Okresy, w których to miejsce jest otwarte w ciągu tygodnia. Okresy są podane w porządku chronologicznym w lokalnej strefie czasowej. Pusta (ale nie nieobecna) wartość oznacza miejsce, które nigdy nie jest otwarte, np. z powodu tymczasowego zamknięcia z powodu remontu.

Dzień rozpoczęcia periods NIE jest stały i nie należy zakładać, że jest to niedziela. Interfejs API określa dzień rozpoczęcia na podstawie różnych czynników. W przypadku firmy działającej przez całą dobę pierwszy okres może rozpocząć się w dniu przesłania prośby. W przypadku innych firm może to być pierwszy dzień tygodnia, w którym są otwarte.

UWAGA: kolejność tablicy periods jest niezależna od kolejności tablicy weekday_descriptions. Nie zakładaj, że zaczną się tego samego dnia.

string

Zlokalizowane ciągi znaków opisujące godziny otwarcia tego miejsca, po jednym ciągu znaków na każdy dzień tygodnia.

UWAGA: kolejność dni i początek tygodnia zależą od ustawień regionalnych (języka i regionu). Kolejność tablicy periods jest niezależna od kolejności tablicy weekday_descriptions. Nie zakładaj, że zaczną się tego samego dnia.

Będzie pusta, jeśli godziny są nieznane lub nie można ich przekonwertować na tekst w odpowiednim języku. Przykład: „Sun: 18:00–06:00”

SecondaryHoursType

Ciąg znaków typu służący do identyfikowania typu dodatkowych godzin otwarcia.

SpecialDay

Uporządkowane informacje o dniach specjalnych, które przypadają w okresie, którego dotyczą zwrócone godziny otwarcia. Dni specjalne to dni, które mogą mieć wpływ na godziny otwarcia miejsca, np. Boże Narodzenie. Ustaw wartości dla atrybutów current_opening_hours i current_secondary_opening_hours, jeśli obowiązują wyjątkowe godziny otwarcia.

Timestamp

Następny okres bieżących godzin otwarcia rozpoczyna się w ciągu 7 dni. To pole jest wypełniane tylko wtedy, gdy w momencie obsługi żądania okres godzin otwarcia nie jest aktywny.

Timestamp

Następny okres bieżących godzin otwarcia kończy się w ciągu 7 dni. To pole jest wypełniane tylko wtedy, gdy w momencie obsługi żądania okres godzin otwarcia jest aktywny.

bool

Określa, czy okres godzin otwarcia jest obecnie aktywny. W przypadku standardowych i aktualnych godzin otwarcia to pole oznacza, czy miejsce jest otwarte. W przypadku dodatkowych godzin otwarcia i bieżących dodatkowych godzin otwarcia to pole oznacza, czy dodatkowe godziny otwarcia tego miejsca są aktywne.

Point

Godzina otwarcia miejsca.

Point

Godzina, o której miejsce zaczyna być zamknięte.

Date

Data w lokalnej strefie czasowej dla danego miejsca.

bool

Określa, czy ten punkt końcowy został skrócony. Obcinanie następuje, gdy rzeczywiste godziny są poza zakresem godzin, które chcemy zwracać, więc obcinamy godziny do tych granic. Dzięki temu zwracamy dane z okresu maksymalnie 24 * 7 godzin od północy dnia, w którym wysłano żądanie.

int32

Dzień tygodnia jako liczba całkowita z zakresu 0–6. 0 to niedziela, 1 to poniedziałek itd.

int32

Godzina w formacie 24-godzinnym. Zakres od 0 do 23.

int32

Minuta. Zakres od 0 do 59.

Date

Data tego wyjątkowego dnia.

bool

Obiekt oferuje bezpłatne miejsca parkingowe.

bool

Dostępne są płatne parkingi.

bool

Obiekt oferuje bezpłatny parking przy ulicy.

bool

Dostępny jest płatny parking przy ulicy.

bool

Obiekt oferuje parking z obsługą.

bool

Obiekt oferuje bezpłatny parking w garażu.

bool

Dostępny jest płatny parking w garażu.

bool

Miejsce akceptuje karty kredytowe jako formę płatności.

bool

Miejsce akceptuje karty debetowe jako formę płatności.

bool

W tym miejscu można płacić tylko gotówką. Miejsca z tym atrybutem mogą nadal akceptować inne formy płatności.

bool

Miejsce akceptuje płatności NFC.

string

Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, reprezentujący obszar o wymiarach 1/8000 stopnia na 1/8000 stopnia (~14 x 14 metrów).

string

Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, zawierający sufiks kodu globalnego i zastępujący prefiks sformatowaną nazwą elementu odniesienia.

LocalizedText

Podsumowanie opinii użytkowników.

string

Link, za pomocą którego użytkownicy mogą zgłosić problem z podsumowaniem.

LocalizedText

Informacja o wykorzystaniu AI „Podsumowano za pomocą Gemini” (i jej wersje w innych językach). Jeśli to możliwe, będzie on dostępny w języku określonym w żądaniu.

string

link do opinii o tym miejscu w Mapach Google;

string

Nazwa zasobu miejsca docelowego.

string

Identyfikator miejsca podrzędnego miejsca docelowego.

string

Zakodowana linia łamana, która jest domyślnie zwracana przez interfejs Routes API. Zapoznaj się z narzędziami enkoder i dekoder.

Money

Dolna granica przedziału cenowego (włącznie). Cena powinna być równa tej kwocie lub wyższa.

Money

Górna granica przedziału cenowego (wyłącznie). Cena powinna być niższa niż ta kwota.

string

Odwołanie do tej opinii o miejscu, które może być używane do ponownego wyszukiwania tej opinii (nazywane też nazwą „zasobu” interfejsu API: places/{place_id}/reviews/{review}).

string

Ciąg znaków sformatowanego niedawnego czasu, wyrażający czas opinii w stosunku do bieżącego czasu w formie odpowiedniej dla języka i kraju.

LocalizedText

Zlokalizowany tekst opinii.

LocalizedText

Tekst opinii w języku oryginalnym.

double

Liczba z zakresu od 1,0 do 5,0, zwana też liczbą gwiazdek.

AuthorAttribution

Autor opinii.

Timestamp

Sygnatura czasowa opinii.

string

Link, za pomocą którego użytkownicy mogą zgłosić problem z opinią.

string

link do wyświetlenia opinii w Mapach Google;

Date

Data wizyty autora w danym miejscu. Jest on skrócony do roku i miesiąca wizyty.

bool

Opcjonalnie. Jeśli ta wartość jest ustawiona na „true”, usługa unika dróg płatnych, gdy jest to uzasadnione, i preferuje trasy, które nie zawierają dróg płatnych. Dotyczy tylko urządzeń DRIVE i TWO_WHEELER TravelMode.

bool

Opcjonalnie. Jeśli ta opcja jest ustawiona na „true”, aplikacja unika autostrad, gdy jest to możliwe, i preferuje trasy, które ich nie zawierają. Dotyczy tylko urządzeń DRIVE i TWO_WHEELER TravelMode.

bool

Opcjonalnie. Jeśli ta opcja jest ustawiona na „true”, usługa unika promów, gdy jest to uzasadnione, i preferuje trasy, które ich nie obejmują. Dotyczy tylko urządzeń DRIVE i TWO_WHEELER TravelMode.

bool

Opcjonalnie. Jeśli ta opcja jest ustawiona na „true”, nawigacja w pomieszczeniach jest unikana, gdy jest to możliwe. Preferowane są trasy, które nie zawierają nawigacji w pomieszczeniach. Dotyczy tylko WALK TravelMode.

LatLng

Opcjonalnie. Jawne miejsce początkowe trasy, które zastępuje źródło zdefiniowane w linii łamanej. Domyślnie używane jest źródło polilinii.

TravelMode

Opcjonalnie. środek transportu,

RouteModifiers

Opcjonalnie. Modyfikatory trasy.

RoutingPreference

Opcjonalnie. Określa sposób obliczania podsumowań routingu. Serwer próbuje obliczyć trasę przy użyciu wybranej preferencji routingu. Preferencje routingu z uwzględnieniem ruchu są dostępne tylko w przypadku DRIVE lub TWO_WHEELER travelMode.

Leg

etapy podróży,

Gdy obliczasz czas podróży i odległość od ustalonego punktu początkowego, element legs zawiera 1 etap z czasem podróży i odległością od punktu początkowego do docelowego. Gdy wyszukujesz trasę wzdłuż trasy, parametr legs zawiera 2 etapy: jeden z miejsca wyjazdu do miejsca docelowego, a drugi z miejsca docelowego do miejsca docelowego.

string

Link do wyświetlania wskazówek dojazdu w Mapach Google z użyciem punktów pośrednich z podsumowania trasy. Trasa wygenerowana przez ten link nie musi być taka sama jak trasa użyta do wygenerowania podsumowania routingu. Link wykorzystuje informacje podane w prośbie, w tym w polach routingParameters i searchAlongRouteParameters (w stosownych przypadkach), aby wygenerować link do wskazówek dojazdu.

Duration

Czas potrzebny na pokonanie tego odcinka podróży.

int32

Długość tego etapu podróży.

string

Informacje o miejscu będą wyświetlane w preferowanym języku, jeśli jest on dostępny. Jeśli kod języka jest nieokreślony lub nierozpoznany, mogą zostać zwrócone szczegóły miejsca w dowolnym języku, przy czym preferowany jest język angielski, jeśli takie szczegóły istnieją.

Aktualna lista obsługiwanych języków: https://developers.google.com/maps/faq#languagesupport.

string

Kod Unicode kraju lub regionu (CLDR) lokalizacji, z której pochodzi żądanie. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie, jeśli jest dostępna. W zależności od obowiązujących przepisów parametr może wpływać na wyniki.

Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Pamiętaj, że 3-cyfrowe kody regionów nie są obecnie obsługiwane.

string

Typ miejsca (np. „restaurant” lub „gas_station”) z https://developers.google.com/maps/documentation/places/web-service/place-types.

Możesz określić maksymalnie 50 typów z tabeli A.

Jeśli występują typy powodujące konflikt, tzn. typ pojawia się zarówno w polu included_types, jak i w polu excluded_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład mamy {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, zwrócone miejsca świadczą usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.

string

Wykluczony typ miejsca (np. „restaurant” lub „gas_station”) ze strony https://developers.google.com/maps/documentation/places/web-service/place-types.

Możesz określić maksymalnie 50 typów z tabeli A.

Jeśli klient poda zarówno included_types (np. restauracja), jak i excluded_types (np. kawiarnia), odpowiedź powinna zawierać miejsca, które są restauracjami, ale nie kawiarniami. Odpowiedź zawiera miejsca, które pasują do co najmniej jednego z typów uwzględnionych i do żadnego z typów wykluczonych.

Jeśli występują typy powodujące konflikt, tzn. typ pojawia się zarówno w polu included_types, jak i w polu excluded_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład mamy {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, zwrócone miejsca świadczą usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.

string

Główny typ miejsca (np. „restaurant” lub „gas_station”) z listy https://developers.google.com/maps/documentation/places/web-service/place-types. Miejsce może mieć tylko jeden typ podstawowy z tabeli obsługiwanych typów.

Możesz określić maksymalnie 50 typów z tabeli A.

Jeśli występują sprzeczne typy podstawowe, tzn. typ pojawia się zarówno w polu included_primary_types, jak i excluded_primary_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład mamy {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, zwrócone miejsca świadczą usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.

string

Wykluczony podstawowy typ miejsca (np. „restaurant” lub „gas_station”) ze strony https://developers.google.com/maps/documentation/places/web-service/place-types.

Możesz określić maksymalnie 50 typów z tabeli A.

Jeśli występują sprzeczne typy podstawowe, tzn. typ pojawia się zarówno w polu included_primary_types, jak i excluded_primary_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład mamy {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, zwrócone miejsca świadczą usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.

int32

Maksymalna liczba wyników do zwrócenia. Musi mieścić się w przedziale od 1 do 20 (wartość domyślna) włącznie. Jeśli liczba nie jest ustawiona, wraca do górnego limitu. Jeśli liczba jest ujemna lub przekracza górny limit, zwracany jest błąd INVALID_ARGUMENT.

LocationRestriction

Wymagane. Region, w którym ma się odbywać wyszukiwanie.

RankPreference

Określa kolejność wyników w odpowiedzi.

RoutingParameters

Opcjonalnie. Parametry, które wpływają na kierowanie do wyników wyszukiwania.

bool

Opcjonalnie. Jeśli tak, uwzględnij firmy, które nie są jeszcze otwarte, ale zostaną otwarte w przyszłości.

Circle

Okrąg zdefiniowany przez punkt środkowy i promień.

Place

Lista miejsc spełniających wymagania użytkownika, takie jak typy miejsc, liczba miejsc i określone ograniczenie lokalizacji.

RoutingSummary

Lista podsumowań routingu, w której każdy wpis jest powiązany z odpowiednim miejscem o tym samym indeksie w polu places. Jeśli podsumowanie wyznaczania trasy jest niedostępne dla jednego z miejsc, będzie zawierać pusty wpis. Jeśli jest to wymagane, ta lista powinna zawierać tyle samo pozycji co lista miejsc.

string

Wymagane. Zapytanie tekstowe do wyszukiwania tekstowego.

string

Informacje o miejscu będą wyświetlane w preferowanym języku, jeśli jest on dostępny. Jeśli kod języka jest nieokreślony lub nierozpoznany, mogą zostać zwrócone szczegóły miejsca w dowolnym języku, przy czym preferowany jest język angielski, jeśli takie szczegóły istnieją.

Aktualna lista obsługiwanych języków: https://developers.google.com/maps/faq#languagesupport.

string

Kod Unicode kraju lub regionu (CLDR) lokalizacji, z której pochodzi żądanie. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie, jeśli jest dostępna. W zależności od obowiązujących przepisów parametr może wpływać na wyniki.

Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Pamiętaj, że 3-cyfrowe kody regionów nie są obecnie obsługiwane.

RankPreference

Określa kolejność wyników w odpowiedzi.

string

Rodzaj miejsca, o który prosisz. Pełna lista obsługiwanych typów: https://developers.google.com/maps/documentation/places/web-service/place-types. Obsługuje tylko 1 typ.

bool

Służy do ograniczenia wyszukiwania do miejsc, które są obecnie otwarte. Wartość domyślna to false.

double

Odfiltrowuje wyniki, których średnia ocena użytkowników jest ściśle mniejsza niż ten limit. Prawidłowa wartość musi być liczbą zmiennoprzecinkową z zakresu od 0 do 5 (włącznie) z krokiem 0,5, czyli [0, 0,5, 1,0, ..., 5,0] włącznie. Wpisana ocena zostanie zaokrąglona w górę do najbliższej wartości 0,5. Na przykład ocena 0,6 wyeliminuje wszystkie wyniki z oceną poniżej 1,0.

int32

Wycofana: zamiast niej używaj zasady page_size.

Maksymalna liczba wyników na stronę, które można zwrócić. Jeśli liczba dostępnych wyników jest większa niż max_result_count, zwracany jest element next_page_token, który można przekazać do funkcji page_token, aby w kolejnych żądaniach uzyskać następną stronę wyników. Jeśli podasz wartość 0 lub nie podasz żadnej wartości, zostanie użyta wartość domyślna 20. Maksymalna wartość to 20. Wartości powyżej 20 zostaną zaokrąglone do 20. Wartości ujemne spowodują zwrócenie błędu INVALID_ARGUMENT.

Jeśli podasz zarówno parametr max_result_count, jak i page_size, parametr max_result_count zostanie zignorowany.

int32

Opcjonalnie. Maksymalna liczba wyników na stronę, które można zwrócić. Jeśli liczba dostępnych wyników jest większa niż page_size, zwracany jest element next_page_token, który można przekazać do funkcji page_token, aby w kolejnych żądaniach uzyskać następną stronę wyników. Jeśli podasz wartość 0 lub nie podasz żadnej wartości, zostanie użyta wartość domyślna 20. Maksymalna wartość to 20. Wartości powyżej 20 zostaną ustawione na 20. Wartości ujemne spowodują zwrócenie błędu INVALID_ARGUMENT.

Jeśli podasz zarówno parametr max_result_count, jak i page_size, parametr max_result_count zostanie zignorowany.

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania TextSearch. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie parametry przekazane do TextSearch z wyjątkiem page_token, page_size i max_result_count muszą być zgodne z pierwotnym wywołaniem, które dostarczyło token strony. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

PriceLevel

Służy do ograniczania wyszukiwania do miejsc oznaczonych określonymi poziomami cen. Użytkownicy mogą wybrać dowolną kombinację poziomów cen. Domyślnie wybrane są wszystkie poziomy cenowe.

bool

Służy do ustawiania ścisłego filtrowania typu w przypadku parametru included_type. Jeśli ma wartość Prawda, zwracane są tylko wyniki tego samego typu. Wartość domyślna to fałsz.

LocationBias

Region, w którym ma się odbywać wyszukiwanie. Ta lokalizacja służy jako punkt odniesienia, co oznacza, że mogą być zwracane wyniki w jej pobliżu. Nie można go ustawić razem z parametrem location_restriction.

LocationRestriction

Region, w którym ma się odbywać wyszukiwanie. Ta lokalizacja służy jako ograniczenie, co oznacza, że wyniki spoza podanej lokalizacji nie będą zwracane. Nie można go ustawić razem z parametrem location_bias.

EVOptions

Opcjonalnie. Ustaw opcje wyszukiwania pojazdów elektrycznych w żądaniu wyszukiwania miejsca.

RoutingParameters

Opcjonalnie. Dodatkowe parametry kierowania do wyników.

SearchAlongRouteParameters

Opcjonalnie. Dodatkowy protokół parametrów do wyszukiwania miejsc przy trasie.

bool

Opcjonalnie. Uwzględnij firmy działające tylko na określonym obszarze, jeśli pole ma wartość true. Firma działająca tylko na określonym obszarze to firma, która świadczy usługi na miejscu u klienta lub samodzielnie dostarcza produkty odbiorcom, ale nie obsługuje klientów pod swoim adresem. Mogą to być hydraulicy lub firmy świadczące usługi sprzątania. Nie mają one fizycznego adresu ani lokalizacji w Mapach Google. W przypadku tych firm Miejsca nie będą zwracać pól, w tym location, plus_code i innych pól związanych z lokalizacją.

bool

Opcjonalnie. Jeśli tak, uwzględnij firmy, które nie są jeszcze otwarte, ale zostaną otwarte w przyszłości.

double

Opcjonalnie. Minimalna wymagana moc ładowania w kilowatach. Miejsce z szybkością ładowania niższą niż określona zostanie odfiltrowane.

EVConnectorType

Opcjonalnie. Lista preferowanych typów złączy EV. Miejsce, które nie obsługuje żadnego z wymienionych typów złączy, jest odfiltrowywane.

Viewport

Prostokąt określony przez północno-wschodni i południowo-zachodni róg. rectangle.high() musi być punktem północno-wschodnim prostokątnego obszaru widocznego. rectangle.low() musi być południowo-zachodnim punktem prostokątnego obszaru widocznego. Wartość rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to powstanie pustego zakresu szerokości geograficznej. Prostokątny widok nie może być szerszy niż 180 stopni.

Circle

Okrąg zdefiniowany przez punkt środkowy i promień.

Viewport

Prostokąt określony przez północno-wschodni i południowo-zachodni róg. rectangle.high() musi być punktem północno-wschodnim prostokątnego obszaru widocznego. rectangle.low() musi być południowo-zachodnim punktem prostokątnego obszaru widocznego. Wartość rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to powstanie pustego zakresu szerokości geograficznej. Prostokątny widok nie może być szerszy niż 180 stopni.

Polyline

Wymagane. linia łamana trasy,

Place

Lista miejsc spełniających kryteria wyszukiwania tekstowego użytkownika.

RoutingSummary

Lista podsumowań routingu, w której każdy wpis jest powiązany z odpowiednim miejscem o tym samym indeksie w polu places. Jeśli podsumowanie wyznaczania trasy jest niedostępne dla jednego z miejsc, będzie zawierać pusty wpis. Lista będzie zawierać tyle wpisów, ile jest miejsc na liście, jeśli o to poprosisz.

ContextualContent

Eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Lista treści kontekstowych, w której każdy wpis jest powiązany z odpowiednim miejscem w tym samym indeksie w polu places. Preferowane są treści, które są istotne dla text_query w żądaniu. Jeśli treści kontekstowe nie są dostępne w przypadku jednego z miejsc, zostaną zwrócone treści bez kontekstu. Będzie ona pusta tylko wtedy, gdy treści dotyczące tego miejsca są niedostępne. Lista będzie zawierać tyle wpisów, ile jest miejsc na liście, jeśli o to poprosisz.

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole lub pozostawisz je puste, nie będzie kolejnych stron.

string

Link umożliwia użytkownikowi wyszukiwanie w Mapach Google za pomocą tego samego zapytania tekstowego, które zostało określone w żądaniu.

LocalizedText

Nazwa agencji (np. „VTA”) w żądanym języku.

string

Adres URL strony głównej agencji.

string

URL strony z informacjami o taryfach agencji.

TransitIcon

Identyfikator ikony zlokalizowanej ikony marki systemu transportu publicznego (np. metra w Londynie), która powinna być używana w interfejsie zamiast TransitLine.vehicle_icon.

TransitLine

Linie transportu publicznego obsługiwane przez tę agencję.

string

Adres URL ikony.

bool

Czy nazwa jest zawarta w ikonie i nie trzeba jej wyświetlać obok niej.

string

Identyfikator linii transportu publicznego, który umożliwia jednoznaczne zidentyfikowanie linii wśród innych linii transportu publicznego na tej samej stacji transportu publicznego. Nie ma gwarancji, że ten identyfikator będzie stabilny w różnych odpowiedziach.

VehicleType

Rodzaj pojazdu korzystającego z tej linii.

LocalizedText

Długa nazwa tej linii transportu publicznego (np. „Sunnydale local”).

LocalizedText

Krótka nazwa tej linii transportu publicznego (np. „S2”).

string

Kolor tekstu etykiet dla tej linii transportu publicznego w formacie szesnastkowym #RRGGBB, np. #909CE1.

string

Kolor tła etykiet dla tej linii transportu publicznego w formacie szesnastkowym #RRGGBB, np. #909CE1. Ten kolor może być też używany do rysowania kształtów dla tej linii transportu publicznego.

string

Adres URL strony internetowej ze szczegółowymi informacjami o tym wierszu.

TransitIcon

Identyfikator ikony dla tej konkretnej linii (np. linie metra w Nowym Jorku).

TransitIcon

Identyfikator ikony dla tego typu pojazdu.

LocalizedText

Nazwa stacji w języku lokalnym.

TransitAgency

Przewoźnicy obsługujący tę stację.

TransitStop

Przystanki transportu publicznego na tej stacji.

string

Identyfikator przystanku transportu publicznego, który umożliwia jednoznaczną identyfikację przystanku wśród innych przystanków na tej samej stacji transportu publicznego. Nie ma gwarancji, że ten identyfikator będzie stabilny w różnych odpowiedziach.

LocalizedText

Nazwa przystanku.

LocalizedText

Kod platformy reprezentowany przez ten przystanek. Można go sformatować w dowolny sposób. (np. „2”, „Platforma 2”, „2–4” lub „1x”).

LocalizedText

Tekst dosłowny napisany na tablicy informacyjnej na tej platformie, np. „W kierunku centrum” lub „Wschodnia strona i Brooklyn”. Jeśli pole platform_code nie występuje, to pole może być jedynym identyfikatorem platformy. Można jednak ustawić jednocześnie pola platform_code i signage_text.

LocalizedText

Identyfikator przystanku czytelny dla człowieka, używany przez przewoźników do odróżniania przystanków o tej samej nazwie.

LatLng

Lokalizacja przystanku.

bool

Dostępność tego przystanku dla osób na wózkach. To pole wskazuje, czy istnieje dostępna ścieżka z zewnątrz stacji do przystanku. Nie wskazuje, czy na przystanku można wsiąść do pojazdu.