Package google.maps.places.v1

Indeks

Miejsca

Definicja usługi Places API. Uwaga: każde żądanie (z wyjątkiem żądań Autocomplete i GetPhotoMedia) wymaga ustawienia maski pola poza protokołem żądania (all/*, nie jest zakładana). Maskę pola można ustawić za pomocą nagłówka HTTP X-Goog-FieldMask. Zobacz: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Zwraca prognozy dla podanych danych wejściowych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Pobierz plik multimedialny ze zdjęciem, używając ciągu odniesienia do zdjęcia.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

Uzyskaj szczegółowe informacje o miejscu na podstawie jego nazwy zasobu, która jest ciągiem tekstowym w formacie places/{place_id}.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

wyszukiwać miejsca w pobliżu lokalizacji;

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Wyszukiwanie miejsc na podstawie zapytania tekstowego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

Relacyjny opis lokalizacji. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych oraz dokładne obszary zawierające i ich związek z lokalizacją docelową.

Pola
landmarks[]

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.
areas[]

Area

Lista zawierająca obszary, w których znajduje się wyszukiwane miejsce lub które z nim sąsiadują, posortowana według rankingu. Najbardziej rozpoznawalne i precyzyjne obszary są wyświetlane jako pierwsze.

Obszar

Informacje o obszarze i jego powiązanie z lokalizacją docelową.

Obszary obejmują dokładne podlokalizacje, dzielnice i duże kompleksy, które są przydatne do opisywania lokalizacji.

Pola
name

string

Nazwa zasobu obszaru.
place_id

string

Identyfikator miejsca obszaru.
display_name

LocalizedText

Wyświetlana nazwa obszaru.
containment

Containment

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

Zawieranie

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

Wartości w polu enum
CONTAINMENT_UNSPECIFIED Nie określono, czy element jest zawarty w innym elemencie.
WITHIN Lokalizacja docelowa znajduje się w regionie obszaru, blisko jego środka.
OUTSKIRTS Lokalizacja docelowa znajduje się w regionie obszaru, blisko jego krawędzi.
NEAR Lokalizacja docelowa znajduje się poza regionem obszaru, ale w jego pobliżu.

Punkt orientacyjny

podstawowe informacje o punkcie orientacyjnym i jego powiązanie z lokalizacją docelową;

Punkty orientacyjne to znane miejsca, które można wykorzystać do opisu lokalizacji.

Pola
name

string

Nazwa zasobu punktu orientacyjnego.
place_id

string

Identyfikator miejsca punktu orientacyjnego.
display_name

LocalizedText

Wyświetlana nazwa punktu orientacyjnego.
types[]

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.
spatial_relationship

SpatialRelationship

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

float

Odległość w metrach w linii prostej między środkiem punktu docelowego a środkiem punktu orientacyjnego. W niektórych sytuacjach ta wartość może być większa niż travel_distance_meters.
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. pieszo, samochodem czy rowerem.

SpatialRelationship

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

Wartości w polu enum
NEAR Jest to domyślna relacja, gdy nie ma zastosowania żadna z poniższych.
WITHIN Punkt orientacyjny ma geometrię przestrzenną, a cel znajduje się w jego granicach.
BESIDE Cel znajduje się bezpośrednio obok punktu orientacyjnego.
ACROSS_THE_ROAD Cel znajduje się bezpośrednio naprzeciwko punktu orientacyjnego po drugiej stronie drogi.
DOWN_THE_ROAD Na tej samej trasie co punkt orientacyjny, ale nie obok niego ani nie po drugiej stronie.
AROUND_THE_CORNER Nie na tej samej trasie co punkt orientacyjny, ale w odległości jednego skrętu.
BEHIND Blisko obiektu, ale dalej od wejść od strony ulicy.

AuthorAttribution

Informacje o autorze danych wygenerowanych przez użytkowników. Użyto w: Photo i Review.

Pola
display_name

string

Imię i nazwisko autora Photo lub Review.
uri

string

Identyfikator URI autora Photo lub Review.
photo_uri

string

Identyfikator URI zdjęcia profilowego autora Photo lub Review.

AutocompletePlacesRequest

Protokół żądania dla AutocompletePlaces.

Pola
input

string

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

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.
location_restriction

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.
included_primary_types[]

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.
included_region_codes[]

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.
language_code

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.
region_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 na to, jakie wyniki są zwracane. Nie ogranicza to wyników do określonego regionu. Aby ograniczyć wyniki do regionu, użyj ikony region_code_restriction.
origin

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.
input_offset

int32

Opcjonalnie. Przesunięcie znaku Unicode liczone od zera, wynoszące input, które wskazuje 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.
include_query_predictions

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.
session_token

string

Opcjonalnie. Ciąg tekstowy, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny ciąg znaków base64, który można używać w adresach URL i nazwach plików. 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 interfejsu Place Details lub Address Validation. Każda sesja może zawierać wiele zapytań, po których następuje 1 żądanie szczegółów miejsca lub weryfikacji adresu. Dane logowania używane w każdym żądaniu w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. 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 funkcji Autouzupełnianie miejsc.
  • Generuj nowy token dla każdej sesji. Zalecamy używanie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane w przypadku wszystkich żądań autouzupełniania miejsc, szczegółów miejsca i weryfikacji adresu w ramach sesji należą do tego samego projektu w konsoli Cloud.
  • Pamiętaj, aby w przypadku każdej nowej sesji przekazywać unikalny token sesji. Użycie tego samego tokena w więcej niż jednej sesji spowoduje, że każde żądanie będzie rozliczane osobno.
include_pure_service_area_businesses

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. Miejsca nie będą zwracać pól, w tym location, plus_code i innych pól związanych z lokalizacją tych firm.

LocationBias

Region, w którym ma się odbywać wyszukiwanie. Wyniki mogą być obciążone w odniesieniu do określonego regionu.

Pola

Pole zbiorcze type.

Pole type może mieć tylko jedną z tych wartości:
rectangle

Viewport

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

Circle

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

LocationRestriction

Region, w którym ma się odbywać wyszukiwanie. Wyniki zostaną ograniczone do określonego regionu.

Pola

Pole zbiorcze type.

Pole type może mieć tylko jedną z tych wartości:
rectangle

Viewport

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

Circle

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

AutocompletePlacesResponse

Protokół odpowiedzi dla AutocompletePlaces.

Pola
suggestions[]

Suggestion

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

Sugestia

Wynik sugestii autouzupełniania.

Pola

Pole zbiorcze kind.

Pole kind może mieć tylko jedną z tych wartości:
place_prediction

PlacePrediction

Prognoza dla miejsca.
query_prediction

QueryPrediction

Prognoza dotycząca zapytania.

FormattableText

Tekst reprezentujący miejsce lub prognozę zapytania. Tekst może być używany w niezmienionej postaci lub sformatowany.

Pola
text

string

Tekst, którego można użyć w niezmienionej formie lub sformatować za pomocą matches.
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.

PlacePrediction

Wyniki prognozowania dla podpowiedzi autouzupełniania miejsca.

Pola
place

string

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

string

Unikalny identyfikator sugerowanego miejsca. Ten identyfikator można używać w innych interfejsach API, które akceptują identyfikatory miejsc.
text

FormattableText

Zawiera czytelną 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ć przekształcać structured_format w text ani na odwrót.

Ten tekst może się różnić od wartości display_name zwracanej przez GetPlace.

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 miejsce nie ma tłumaczenia z języka lokalnego na język language_code.
structured_format

StructuredFormat

Podział prognozy miejsca 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świetlać tylko jeden element interfejsu, mogą zamiast tego użyć elementu text. Są to 2 różne sposoby przedstawiania prognozy dotyczącej miejsca. Użytkownicy nie powinni próbować przekształcać structured_format w text ani na odwrót.
types[]

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.
distance_meters

int32

Długość linii geodezyjnej w metrach od punktu origin, jeśli jest on określony.origin Niektóre prognozy, np. trasy, mogą nie wypełniać tego pola.

QueryPrediction

Wyniki prognoz dla podpowiedzi autouzupełniania zapytania.

Pola
text

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ć przekształcać 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.
structured_format

StructuredFormat

Podział prognozy zapytania na tekst główny zawierający zapytanie i tekst dodatkowy zawierający dodatkowe funkcje uściślają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świetlać tylko jeden element interfejsu, mogą zamiast tego użyć elementu text. Są to 2 różne sposoby przedstawiania prognozy zapytania. Użytkownicy nie powinni próbować przekształcać structured_format w text ani na odwrót.

StringRange

Określa podciąg w danym tekście.

Pola
start_offset

int32

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

int32

Indeks ostatniego znaku Unicode (liczony od zera, wyłączony).

StructuredFormat

Zawiera podział prognozy miejsca lub zapytania na tekst główny i tekst dodatkowy.

W przypadku prognoz dotyczących miejsca główny tekst zawiera konkretną nazwę miejsca. W przypadku prognoz zapytań główny tekst zawiera zapytanie.

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

Pola
main_text

FormattableText

Zawiera nazwę miejsca lub zapytania.
secondary_text

FormattableText

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

Okrąg

Okrąg ze środkiem i promieniem w postaci obiektu LatLng.

Pola
center

LatLng

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

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

double

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

ContentBlock

Blok treści, który można wyświetlać osobno.

Pola
content

LocalizedText

treści związane z tematem;
referenced_places[]

string

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

ContextualContent

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

treści kontekstowe w stosunku do zapytania o miejsce;

Pola
reviews[]

Review

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

Photo

Informacje (w tym odniesienia) o zdjęciach tego miejsca, powiązane z zapytaniem o miejsce.
justifications[]

Justification

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

uzasadnienia dotyczące miejsca;

Uzasadnienie

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

uzasadnienia dotyczące miejsca; Uzasadnienia odpowiadają na pytanie, dlaczego dane miejsce może zainteresować użytkownika.

Pola

Pole zbiorcze justification.

Pole justification może mieć tylko jedną z tych wartości:
review_justification

ReviewJustification

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

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributesJustification

Eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Uzasadnienia atrybutów dostępności firmy. Wyświetla niektóre atrybuty firmy, które mogą zainteresować użytkownika końcowego.

Pola
takeout

bool

Czy miejsce oferuje dania na wynos.
delivery

bool

Czy to miejsce oferuje dostawę.
dine_in

bool

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

ReviewJustification

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

uzasadnienia opinii użytkowników, Wyróżnia to fragment opinii użytkownika, który może zainteresować użytkownika końcowego. Jeśli na przykład wyszukiwane hasło to „pizza z pieca opalanego drewnem”, uzasadnienie opinii wyróżnia tekst związany z tym hasłem.

Pola
highlighted_text

HighlightedText
review

Review

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

HighlightedText

Tekst wyróżniony przez uzasadnienie. Jest to podzbiór samej opinii. Dokładne słowo do wyróżnienia jest oznaczone przez HighlightedTextRange. W tekście może być wyróżnionych kilka słów.

Pola
text

string
highlighted_text_ranges[]

HighlightedTextRange

Lista zakresów zaznaczonego tekstu.

HighlightedTextRange

Zakres zaznaczonego tekstu.

Pola
start_index

int32
end_index

int32

EVChargeOptions

Informacje o stacji ładowania EV hostowanej w miejscu. Terminologia jest zgodna z informacjami na stronie https://afdc.energy.gov/fuels/electricity_infrastructure.html. Jedno gniazdo może ładować 1 samochód naraz. Jeden port ma co najmniej 1 złącze. Jedna stacja ma co najmniej 1 gniazdo.

Pola
connector_count

int32

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

ConnectorAggregation

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

ConnectorAggregation

Informacje o ładowaniu EV pogrupowane według [type, max_charge_rate_kw]. Wyświetla zagregowane dane o ładowaniu pojazdów elektrycznych z gniazdami tego samego typu i o takiej samej maksymalnej szybkości ładowania w kW.

Pola
type

EVConnectorType

Typ łącznika tej agregacji.
max_charge_rate_kw

double

Statyczna maksymalna moc ładowania w kW każdego złącza w agregacji.
count

int32

Liczba łączników w tej agregacji.
availability_last_update_time

Timestamp

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

int32

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

int32

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

EVConnectorType

Więcej informacji o typach złączy do ładowania pojazdów elektrycznych znajdziesz na stronie http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107.

Wartości w polu enum
EV_CONNECTOR_TYPE_UNSPECIFIED Nieokreślone oprogramowanie sprzęgające.
EV_CONNECTOR_TYPE_OTHER inne typy złączy.
EV_CONNECTOR_TYPE_J1772 Złącze typu 1 J1772.
EV_CONNECTOR_TYPE_TYPE_2 Złącze IEC 62196 typu 2. Często nazywane MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Złącze typu CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (AC i DC). Na podstawie SAE. Złącze typu 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (AC i DC). Na podstawie złącza typu 2 Mennekes
EV_CONNECTOR_TYPE_TESLA Ogólne oprogramowanie sprzęgające TESLA. W Ameryce Północnej jest to NACS, ale w innych częściach świata może to być inny standard (np. CCS Combo 2 (CCS2) lub GB/T). Ta wartość mniej odzwierciedla rzeczywisty typ złącza, a bardziej możliwość ładowania pojazdu marki Tesla na stacji ładowania należącej do tej firmy.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Typ GB/T odpowiada standardowi GB/T w Chinach. Ten typ obejmuje wszystkie typy GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Nieokreślone gniazdko ścienne.
EV_CONNECTOR_TYPE_NACS North American Charging System (NACS), czyli system ładowania w Ameryce Północnej, znormalizowany jako SAE J3400.

FuelOptions

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

Pola
fuel_prices[]

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.

FuelPrice

Informacje o cenie paliwa danego typu.

Pola
type

FuelType

Rodzaj paliwa.
price

Money

Cena paliwa.
update_time

Timestamp

Czas ostatniej aktualizacji ceny paliwa.

FuelType

Rodzaje paliw.

Wartości w polu enum
FUEL_TYPE_UNSPECIFIED Nieokreślony rodzaj paliwa.
DIESEL olej napędowy,
DIESEL_PLUS Olej napędowy plus.
REGULAR_UNLEADED Regular unleaded.
MIDGRADE Średniooktanowa.
PREMIUM Premium.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG gaz płynny,
E80 E 80.
E85 E 85.
E100 E 100.
METHANE metan,
BIO_DIESEL Bio-diesel.
TRUCK_DIESEL Olej napędowy do ciężarówek.

GetPhotoMediaRequest

Prośba o pobranie zdjęcia miejsca za pomocą nazwy zasobu zdjęcia.

Pola
name

string

Wymagane. Nazwa zasobu multimediów ze zdjęciem 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ć na końcu zasobu zdjęcia ciąg /media.
max_width_px

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.
max_height_px

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.
skip_http_redirect

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.

GetPlaceRequest

Prośba o pobranie miejsca na podstawie jego nazwy zasobu, która jest ciągiem znaków w formacie places/{place_id}.

Pola
name

string

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

string

Opcjonalnie. Szczegóły miejsca 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.
region_code

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.
session_token

string

Opcjonalnie. Ciąg tekstowy, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny ciąg znaków base64, który można używać w adresach URL i nazwach plików. 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 interfejsu Place Details lub Address Validation. Każda sesja może zawierać wiele zapytań, po których następuje 1 żądanie szczegółów miejsca lub weryfikacji adresu. Dane logowania używane w każdym żądaniu w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. 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 funkcji Autouzupełnianie miejsc.
  • Generuj nowy token dla każdej sesji. Zalecamy używanie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane w przypadku wszystkich żądań autouzupełniania miejsc, szczegółów miejsca i weryfikacji adresu w ramach sesji należą do tego samego projektu w konsoli Cloud.
  • Pamiętaj, aby w przypadku każdej nowej sesji przekazywać unikalny token sesji. Użycie tego samego tokena w więcej niż jednej sesji spowoduje, że każde żądanie będzie rozliczane osobno.

Zdjęcie

Informacje o zdjęciu miejsca.

Pola
name

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}).
width_px

int32

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

int32

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

AuthorAttribution

Autorzy tego zdjęcia.
flag_content_uri

string

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

string

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

PhotoMedia

Plik multimedialny ze zdjęciem z interfejsu Places API.

Pola
name

string

Nazwa zasobu multimediów ze zdjęciem w formacie: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

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

Miejsce

Wszystkie informacje reprezentujące miejsce.

Pola
name

string

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

string

Unikalny identyfikator miejsca.
display_name

LocalizedText

Zlokalizowana nazwa miejsca, która może być krótkim opisem zrozumiałym dla człowieka. np. „Google Sydney”, „Starbucks”, „Pyrmont” itp.
types[]

string

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

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 1 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ć nieobecny, jeśli główny typ miejsca nie jest obsługiwany. Jeśli typ podstawowy jest obecny, zawsze jest jednym z typów w polu types.
primary_type_display_name

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ć nieobecny, jeśli główny typ miejsca nie jest obsługiwany.
national_phone_number

string

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

string

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

string

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

string

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

PostalAddress

Adres w formacie adresu pocztowego.
address_components[]

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 zawierające 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.
plus_code

PlusCode

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

LatLng

Położenie tego miejsca.
viewport

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 usług firmy.
rating

double

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

string

Adres URL z dodatkowymi informacjami o tym miejscu.
website_uri

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.
reviews[]

Review

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

OpeningHours

standardowe godziny otwarcia; Pamiętaj, że jeśli miejsce jest zawsze otwarte (24 godziny na dobę), pole close nie zostanie ustawione. Klienci mogą mieć pewność, że „zawsze otwarte” (24 godziny) będzie reprezentowane jako okres open zawierający day o wartości 0, hour o wartości 0 i minute o wartości 0.
time_zone

TimeZone

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

Photo

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

string

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

BusinessStatus

Stan firmy w przypadku danego miejsca.
price_level

PriceLevel

Poziom cen w miejscu.
attributions[]

Attribution

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

string

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

string

Kolor tła ikony_maski w formacie szesnastkowym, np. #909CE1.
current_opening_hours

OpeningHours

godziny otwarcia na najbliższe 7 dni (w tym dzisiaj); Okres rozpoczyna się o północy w dniu przesłania prośby i kończy o 23:59 sześć dni później. To pole zawiera pole podrzędne special_days wszystkich godzin otwarcia ustawionych na daty, w których obowiązują niestandardowe godziny otwarcia.
current_secondary_opening_hours[]

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.
regular_secondary_opening_hours[]

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.
editorial_summary

LocalizedText

Zawiera podsumowanie informacji o miejscu. Podsumowanie składa się z przeglądu tekstowego, 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ć.
payment_options

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.
parking_options

ParkingOptions

Opcje parkowania oferowane przez to miejsce.
sub_destinations[]

SubDestination

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

FuelOptions

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

EVChargeOptions

Informacje o opcjach ładowania pojazdów elektrycznych.
generative_summary

GenerativeSummary

Podsumowanie miejsca wygenerowane przez AI.
containing_places[]

ContainingPlace

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

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.
price_range

PriceRange

Zakres cen powiązany z miejscem.
review_summary

ReviewSummary

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

EvChargeAmenitySummary

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

NeighborhoodSummary

Podsumowanie ciekawych miejsc w pobliżu.
consumer_alert

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.
utc_offset_minutes

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.
user_rating_count

int32

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

bool

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

bool

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

bool

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

bool

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

bool

Określa, czy miejsce obsługuje rezerwacje.
serves_breakfast

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

Miejsce ma menu dla dzieci.
serves_cocktails

bool

W tym miejscu serwowane są koktajle.
serves_dessert

bool

W tym miejscu można zjeść deser.
serves_coffee

bool

Miejsce serwuje kawę.
good_for_children

bool

Miejsce odpowiednie dla dzieci.
allows_dogs

bool

Można wejść z psem.
restroom

bool

Miejsce ma toaletę.
good_for_groups

bool

Miejsce jest przystosowane do obsługi grup.
good_for_watching_sports

bool

Miejsce nadaje się do oglądania sportu.
accessibility_options

AccessibilityOptions

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

bool

Wskazuje, czy miejsce jest firmą działającą wyłącznie na obszarze 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.

AccessibilityOptions

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

Pola
wheelchair_accessible_parking

bool

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

bool

Miejsca mają wejście dla niepełnosprawnych.
wheelchair_accessible_restroom

bool

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

bool

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

AddressComponent

Komponenty strukturalne, które tworzą sformatowany adres, jeśli te informacje są dostępne.

Pola
long_text

string

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

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”.
types[]

string

Tablica wskazująca typy komponentu adresu.
language_code

string

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

Atrybucja

Informacje o dostawcach danych tego miejsca.

Pola
provider

string

Nazwa dostawcy danych o miejscu.
provider_uri

string

Identyfikator URI dostawcy danych o miejscu.

BusinessStatus

Stan firmy w przypadku danego miejsca.

Wartości w polu enum
BUSINESS_STATUS_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
OPERATIONAL Obiekt działa, ale nie musi być teraz otwarty.
CLOSED_TEMPORARILY To miejsce jest tymczasowo zamknięte.
CLOSED_PERMANENTLY To miejsce jest zamknięte na stałe.

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.

Pola
overview

string

Omówienie alertu konsumenckiego.
details

Details

Szczegóły alertu konsumenckiego.
language_code

string

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

Szczegóły

Szczegóły alertu konsumenckiego.

Pola
title

string

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

string

Opis komunikatu alertu konsumenckiego.

ContainingPlace

Informacje o miejscu, w którym znajduje się to miejsce.

Pola
name

string

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

string

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

EvChargeAmenitySummary

Podsumowanie udogodnień w pobliżu stacji ładowania EV. Dotyczy to tylko miejsc typu electric_vehicle_charging_station. Pole overview jest zawsze dostępne, a pozostałe pola są opcjonalne.

Pola
overview

ContentBlock

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

ContentBlock

Podsumowanie opcji kawiarni w pobliżu.
restaurant

ContentBlock

Podsumowanie restauracji w pobliżu.
store

ContentBlock

Podsumowanie sklepów w pobliżu.
flag_content_uri

string

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

LocalizedText

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

GenerativeSummary

Podsumowanie miejsca wygenerowane przez AI.

Pola
overview

LocalizedText

Opis miejsca.
overview_flag_content_uri

string

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

LocalizedText

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

NeighborhoodSummary

Podsumowanie ciekawych miejsc w pobliżu.

Pola
overview

ContentBlock

podsumowanie ogólne dotyczące okolicy,
description

ContentBlock

Szczegółowy opis okolicy.
flag_content_uri

string

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

LocalizedText

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

OpeningHours

Informacje o godzinach otwarcia miejsca.

Pola
periods[]

Period

Okresy, w których to miejsce jest otwarte w ciągu tygodnia. Okresy są podane w porządku chronologicznym w strefie czasowej miejsca. Pusta (ale nie nieobecna) wartość oznacza miejsce, które nigdy nie jest otwarte, np. z powodu tymczasowego zamknięcia na czas 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. Na przykład 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.
weekday_descriptions[]

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 otwarcia są nieznane lub nie można ich przekonwertować na tekst w odpowiednim języku. Przykład: „Sun: 18:00–06:00”
secondary_hours_type

SecondaryHoursType

Ciąg znaków typu używany do identyfikowania typu dodatkowych godzin.
special_days[]

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 dla atrybutów current_opening_hours i current_secondary_opening_hours, jeśli obowiązują niestandardowe godziny otwarcia.
next_open_time

Timestamp

Następny okres bieżących godzin otwarcia rozpocznie 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.
next_close_time

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.
open_now

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.

Okres

Okres, w którym miejsce pozostaje w stanie open_now.

Pola
open

Point

Godzina otwarcia miejsca.
close

Point

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

Punkt

Punkty zmiany statusu.

Pola
date

Date

Data w lokalnej strefie czasowej miejsca.
truncated

bool

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

int32

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

int32

Godzina w formacie 24-godzinnym. Ma zakres od 0 do 23.
minute

int32

Minuta. Wartość musi mieścić się w zakresie od 0 do 59.

SecondaryHoursType

Typ używany do identyfikowania typu godzin dodatkowych.

Wartości w polu enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Wartość domyślna, gdy nie określono dodatkowego typu godziny.
DRIVE_THROUGH Godziny otwarcia okienka drive-through w bankach, restauracjach lub aptekach.
HAPPY_HOUR Happy hour.
DELIVERY Godzina dostawy.
TAKEOUT Godzina odbioru.
KITCHEN Godzina pracy kuchni.
BREAKFAST Godzina śniadania.
LUNCH Godzina lunchu.
DINNER Pora kolacji.
BRUNCH Godzina brunchu.
PICKUP Godzina odbioru.
ACCESS Godziny dostępu do miejsc przechowywania.
SENIOR_HOURS Niestandardowe godziny otwarcia dla seniorów.
ONLINE_SERVICE_HOURS Godziny otwarcia online.

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.

Pola
date

Date

Data tego wyjątkowego dnia.

ParkingOptions

Informacje o opcjach parkowania w danym miejscu. Parking może obsługiwać więcej niż jedną opcję jednocześnie.

Pola
free_parking_lot

bool

Obiekt oferuje bezpłatne miejsca parkingowe.
paid_parking_lot

bool

Dostępne są płatne parkingi.
free_street_parking

bool

Goście mogą korzystać z bezpłatnego parkingu przy ulicy.
paid_street_parking

bool

Dostępny jest płatny parking przy ulicy.
valet_parking

bool

Dostępny jest parking z obsługą.
free_garage_parking

bool

Obiekt oferuje bezpłatny parking w garażu.
paid_garage_parking

bool

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

PaymentOptions

Opcje płatności akceptowane w danym miejscu.

Pola
accepts_credit_cards

bool

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

bool

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

bool

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

bool

Miejsce akceptuje płatności NFC.

PlusCode

Plus Code (http://plus.codes) to odniesienie do lokalizacji w 2 formatach: kod globalny określający prostokąt o wymiarach 14 m × 14 m (1/8000 stopnia) lub mniejszy oraz kod złożony, który zastępuje prefiks lokalizacją odniesienia.

Pola
global_code

string

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

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.

ReviewSummary

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

Pola
text

LocalizedText

Podsumowanie opinii użytkowników.
flag_content_uri

string

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

LocalizedText

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

string

link do opinii o tym miejscu w Mapach Google;

SubDestination

Podmiejsca docelowe to konkretne miejsca powiązane z głównym miejscem. Umożliwiają one użytkownikom wyszukującym informacje o dużych lub złożonych miejscach, takich jak lotnisko, park narodowy, uczelnia czy stadion, znalezienie bardziej szczegółowych miejsc docelowych. Na przykład podrzędne miejsca docelowe na lotnisku mogą obejmować powiązane terminale i parkingi. Miejsca docelowe podrzędne zwracają identyfikator miejsca i nazwę zasobu miejsca, których można użyć w kolejnych żądaniach szczegółów miejsca (nowych), aby pobrać więcej informacji, w tym nazwę wyświetlaną i lokalizację miejsca docelowego podrzędnego.

Pola
name

string

Nazwa zasobu miejsca docelowego podrzędnego.
id

string

Identyfikator miejsca podrzędnego miejsca docelowego.

Linia łamana

Linia łamana trasy. Obsługuje tylko zakodowaną linię łamaną, którą można przekazać jako ciąg znaków i która obejmuje kompresję z minimalną utratą jakości. Jest to domyślne wyjście interfejsu Routes API.

Pola
Pole zbiorcze polyline_type. Zawiera typ linii łamanej. Domyślna wartość wyjściowa interfejsu Routes API to encoded_polyline. polyline_type może mieć tylko jedną z tych wartości:
encoded_polyline

string

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

PriceLevel

Poziom cen w miejscu.

Wartości w polu enum
PRICE_LEVEL_UNSPECIFIED Poziom cen w miejscu jest nieokreślony lub nieznany.
PRICE_LEVEL_FREE Miejsce oferuje bezpłatne usługi.
PRICE_LEVEL_INEXPENSIVE Miejsce oferuje niedrogie usługi.
PRICE_LEVEL_MODERATE Miejsce oferuje usługi w umiarkowanych cenach.
PRICE_LEVEL_EXPENSIVE Miejsce oferuje drogie usługi.
PRICE_LEVEL_VERY_EXPENSIVE Miejsce oferuje bardzo drogie usługi.

PriceRange

Zakres cen powiązany z miejscem. end_price może być nieskonfigurowana, co oznacza zakres bez górnej granicy (np. „Więcej niż 100 zł”).

Pola
start_price

Money

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

Money

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

Sprawdź

Informacje o opinii o miejscu.

Pola
name

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}).
relative_publish_time_description

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.
text

LocalizedText

Zlokalizowany tekst opinii.
original_text

LocalizedText

Tekst opinii w języku oryginalnym.
rating

double

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

AuthorAttribution

Autor tej opinii.
publish_time

Timestamp

Sygnatura czasowa opinii.
flag_content_uri

string

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

string

link do wyświetlenia opinii w Mapach Google;
visit_date

Date

Data wizyty autora w danym miejscu. Jest ona skracana do miesiąca.

RouteModifiers

Zawiera zestaw opcjonalnych warunków, które muszą być spełnione podczas obliczania tras.

Pola
avoid_tolls

bool

Opcjonalnie. Jeśli ma wartość „true”, omija drogi płatne, gdy jest to uzasadnione, i preferuje trasy, które nie zawierają dróg płatnych. Dotyczy tylko urządzeń DRIVE i TWO_WHEELER TravelMode.
avoid_highways

bool

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

bool

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

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 obejmują nawigacji w pomieszczeniach. Dotyczy tylko WALK TravelMode.

RoutingParameters

Parametry do konfigurowania obliczeń routingu do miejsc w odpowiedzi, zarówno wzdłuż trasy (gdzie będzie to miało wpływ na ranking wyników), jak i do obliczania czasu podróży w wynikach.

Pola
origin

LatLng

Opcjonalnie. Jawne źródło routingu, które zastępuje źródło zdefiniowane w linii łamanej. Domyślnie używane jest źródło polilinii.
travel_mode

TravelMode

Opcjonalnie. Środek transportu.
route_modifiers

RouteModifiers

Opcjonalnie. Modyfikatory trasy.
routing_preference

RoutingPreference

Opcjonalnie. Określa sposób obliczania podsumowań routingu. Serwer próbuje obliczyć trasę przy użyciu wybranego ustawienia routingu. Preferencja routingu uwzględniającego ruch jest dostępna tylko w przypadku DRIVE lub TWO_WHEELER travelMode.

RoutingPreference

Zbiór wartości określających czynniki, które należy wziąć pod uwagę przy obliczaniu trasy.

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji dotyczących routingu. Domyślna wartość to TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania aktualnych warunków drogowych. Odpowiednie, gdy warunki na drodze nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości zapewnia najmniejsze opóźnienie. Uwaga: w przypadku TravelMode DRIVE i TWO_WHEELER wybrana trasa i czas trwania są oparte na sieci dróg i średnich warunkach ruchu niezależnych od czasu, a nie na bieżących warunkach drogowych. W związku z tym trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki danego żądania mogą się zmieniać z czasem ze względu na zmiany w sieci dróg, zaktualizowane średnie warunki ruchu i rozproszony charakter usługi. Wyniki mogą się też różnić w przypadku niemal identycznych tras w dowolnym momencie lub z dowolną częstotliwością.
TRAFFIC_AWARE Oblicza trasy z uwzględnieniem aktualnych warunków na drodze. W przeciwieństwie do TRAFFIC_AWARE_OPTIMAL niektóre optymalizacje są stosowane w celu znacznego zmniejszenia opóźnienia.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy z uwzględnieniem aktualnych warunków ruchu, ale bez stosowania większości optymalizacji wydajności. Użycie tej wartości powoduje największe opóźnienie.

RoutingSummary

Czas trwania i odległość od miejsca rozpoczęcia trasy do miejsca w odpowiedzi oraz drugi odcinek z tego miejsca do miejsca docelowego (jeśli zostało to poproszone). Uwaga: dodanie znaku routingSummaries do maski pola bez uwzględnienia w żądaniu parametru routingParameters.origin lub searchAlongRouteParameters.polyline.encodedPolyline spowoduje błąd.

Pola
legs[]

Leg

Etapy podróży.

Gdy obliczasz czas trwania podróży i odległość od ustalonego punktu początkowego, element legs zawiera 1 etap z czasem trwania i odległością od punktu początkowego do docelowego. Gdy wyszukujesz miejsca na trasie, legs zawiera 2 etapy: z miejsca wyjazdu do miejsca docelowego i z miejsca docelowego do miejsca docelowego.
directions_uri

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.

Noga

Etap to pojedyncza część podróży z jednego miejsca do drugiego.

Pola
duration

Duration

Czas potrzebny na pokonanie tego odcinka podróży.
distance_meters

int32

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

SearchNearbyRequest

Prośba o protokół do wyszukiwania w pobliżu.

Pola
language_code

string

Szczegóły miejsca 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.
region_code

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.
included_types[]

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ą sprzeczne typy, tzn. typ pojawia się zarówno w atrybucie included_types, jak i excluded_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z kilkoma 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 oferują usługi związane z „restauracjami”, ale nie działają głównie jako „restauracje”.
excluded_types[]

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ą sprzeczne typy, tzn. typ pojawia się zarówno w atrybucie included_types, jak i excluded_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z kilkoma 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 oferują usługi związane z „restauracjami”, ale nie działają głównie jako „restauracje”.
included_primary_types[]

string

Główny typ miejsca (np. „restaurant” lub „gas_station”) z tej strony: 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 w polu excluded_primary_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z kilkoma 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 oferują usługi związane z „restauracjami”, ale nie działają głównie jako „restauracje”.
excluded_primary_types[]

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 w polu excluded_primary_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z kilkoma 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 oferują usługi związane z „restauracjami”, ale nie działają głównie jako „restauracje”.
max_result_count

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.
location_restriction

LocationRestriction

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

RankPreference

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

RoutingParameters

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

LocationRestriction

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

Pola

Pole zbiorcze type.

Pole type może mieć tylko jedną z tych wartości:
circle

Circle

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

RankPreference

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

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED Wartość RankPreference nie została ustawiona. Domyślnie będzie używane sortowanie według POPULARNOŚCI.
DISTANCE Sortuje wyniki według odległości.
POPULARITY Wyniki są wyświetlane według popularności.

SearchNearbyResponse

Plik proto odpowiedzi na żądanie wyszukiwania w pobliżu.

Pola
places[]

Place

Lista miejsc spełniających wymagania użytkownika, takie jak typy miejsc, liczba miejsc i ograniczenie dotyczące konkretnej lokalizacji.
routing_summaries[]

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 w przypadku jednego z miejsc, będzie zawierać pusty wpis. Jeśli jest to wymagane, lista powinna zawierać tyle samo pozycji co lista miejsc.

SearchTextRequest

Prośba o protokół SearchText.

Pola
text_query

string

Wymagane. Zapytanie tekstowe do wyszukiwania tekstowego.
language_code

string

Szczegóły miejsca 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.
region_code

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.
rank_preference

RankPreference

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

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.
open_now

bool

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

double

Filtruje 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.
max_result_count
(deprecated)

int32

Wycofano: 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, zwracana jest wartość next_page_token, którą 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ą zmienione na 20. Wartości ujemne spowodują zwrócenie błędu INVALID_ARGUMENT.

Jeśli podasz zarówno wartość max_result_count, jak i page_size, wartość max_result_count zostanie zignorowana.
page_size

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, zwracana jest wartość next_page_token, którą 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 wartość max_result_count, jak i page_size, wartość max_result_count zostanie zignorowana.
page_token

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 pierwszym wywołaniem, które dostarczyło token strony. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.
price_levels[]

PriceLevel

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

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. Domyślnie ma wartość fałsz.
location_bias

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.
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.
ev_options

EVOptions

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

RoutingParameters

Opcjonalnie. Dodatkowe parametry kierowania do wyników.
search_along_route_parameters

SearchAlongRouteParameters

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

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. Miejsca nie będą zwracać pól, w tym location, plus_code i innych pól związanych z lokalizacją tych firm.

EVOptions

Opcje wyszukiwania pojazdów elektrycznych w przypadku wyszukiwania miejsca.

Pola
minimum_charging_rate_kw

double

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

EVConnectorType

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

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.

Pola

Pole zbiorcze type.

Pole type może mieć tylko jedną z tych wartości:
rectangle

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

Circle

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

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.

Pola

Pole zbiorcze type.

Pole type może mieć tylko jedną z tych wartości:
rectangle

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.

RankPreference

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

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED W przypadku zapytania kategorycznego, np. „Restauracje w Nowym Jorku”, domyślnym kryterium jest TRAFNOŚĆ. W przypadku zapytań niekategorycznych, takich jak „Mountain View, CA”, zalecamy pozostawienie parametru rankPreference bez ustawienia.
DISTANCE Sortuje wyniki według odległości.
RELEVANCE Uporządkuj wyniki według trafności. Kolejność sortowania jest określana przez normalny stos rankingowy.

SearchAlongRouteParameters

Określa wstępnie obliczoną linię łamaną z interfejsu Routes API, która definiuje trasę wyszukiwania. Wyszukiwanie wzdłuż trasy jest podobne do używania opcji żądania locationBias lub locationRestriction w celu ukierunkowania wyników wyszukiwania. Opcje locationBias i locationRestriction umożliwiają określenie regionu, który ma wpływać na wyniki wyszukiwania, a ta opcja pozwala wpływać na wyniki wyszukiwania wzdłuż trasy podróży.

Wyniki nie muszą znajdować się na podanej trasie, ale są uszeregowane w obszarze wyszukiwania zdefiniowanym przez linię łamaną i opcjonalnie przez locationBias lub locationRestriction na podstawie minimalnego czasu objazdu z miejsca początkowego do docelowego. Wyniki mogą dotyczyć trasy alternatywnej, zwłaszcza jeśli podana linia łamana nie określa optymalnej trasy z miejsca początkowego do docelowego.

Pola
polyline

Polyline

Wymagane. Linia łamana trasy.

SearchTextResponse

Obiekt protobuf odpowiedzi dla SearchText.

Pola
places[]

Place

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

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 w przypadku jednego z miejsc, będzie zawierać pusty wpis. Jeśli poprosisz, lista będzie zawierać tyle wpisów, ile jest miejsc.
contextual_contents[]

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 miejsc. 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 dla tego miejsca są niedostępne. Jeśli poprosisz, lista będzie zawierać tyle wpisów, ile jest miejsc.
next_page_token

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.
search_uri

string

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

TravelMode

Opcje trybu podróży. Te opcje odpowiadają temu, co oferuje interfejs Routes API.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie określono środka transportu. Domyślna wartość to DRIVE.
DRIVE Podróżowanie samochodem osobowym.
BICYCLE Podróżowanie rowerem. Nieobsługiwane w przypadku search_along_route_parameters.
WALK podróżować pieszo; Nieobsługiwane w przypadku search_along_route_parameters.
TWO_WHEELER wszelkiego rodzaju pojazdy dwukołowe z napędem silnikowym, takie jak skutery i motocykle; Pamiętaj, że różni się on od trybu podróży BICYCLE, który obejmuje transport napędzany siłą ludzkich mięśni. Nieobsługiwane w przypadku search_along_route_parameters. Usługa jest dostępna tylko w krajach wymienionych na stronie Kraje i regiony, w których obsługiwane są pojazdy dwukołowe.