Package google.maps.places.v1

Indeks

Miejsca

Definicja usługi w Places API. Uwaga: każde żądanie (z wyjątkiem żądań autouzupełniania) wymaga ustawienia maski pola poza proto żądania (all/* nie jest zakładane). Maskę pola można ustawić w nagłówku 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 multimedialne zdjęcie za pomocą ciągu znaków 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ć miejsc 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 i precyzyjnych obszarów zawierających oraz ich relację z docelową lokalizacją.

Pola
landmarks[]

Landmark

Posortowana lista pobliskich punktów orientacyjnych. Najbardziej rozpoznawalne i najbliższe punkty orientacyjne są klasyfikowane jako pierwsze.
areas[]

Area

Posortowana lista obszarów zawierających lub sąsiadujących. Najbardziej rozpoznawalne i precyzyjne obszary są klasyfikowane jako pierwsze.

Obszar

informacje o obszarze i jego relacji z miejscem docelowym.

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

Pola
name

string

Nazwa zasobu obszaru.
place_id

string

Identyfikator miejsca w miejscach.
display_name

LocalizedText

Wyświetlana nazwa obszaru.
containment

Containment

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

Ograniczenie

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

Wartości w polu enum
CONTAINMENT_UNSPECIFIED Nie określono ograniczeń.
WITHIN Miejsce docelowe znajduje się w regionie obszaru, w pobliżu jego środka.
OUTSKIRTS Miejsce docelowe znajduje się w regionie obszaru, blisko krawędzi.
NEAR Miejsce docelowe znajduje się poza obszarem regionu, ale w pobliżu.

Punkt orientacyjny

podstawowe informacje o obiekcie charakterystycznym oraz jego relację z miejscem docelowym.

Punkty orientacyjne to znane miejsca, które mogą służyć do opisania lokalizacji.

Pola
name

string

Nazwa zasobu punktu orientacyjnego.
place_id

string

Identyfikator miejsca charakterystycznego.
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 elementem orientacyjnym.
straight_line_distance_meters

float

Odległość w prostej linii (w metrach) między środkiem celu a środkiem punktu orientacyjnego. W niektórych sytuacjach ta wartość może być dłuższa niż travel_distance_meters.
travel_distance_meters

float

Odległość do przebycia w metrach wzdłuż sieci drogowej od celu do punktu orientacyjnego (jeśli jest znana). Ta wartość nie uwzględnia środka transportu, np. chodzenia, jazdy samochodem czy jazdy na rowerze.

SpatialRelationship

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

Wartości w polu enum
NEAR Jest to relacja domyślna, gdy nie ma zastosowania żadna z poniżej wymienionych relacji.
WITHIN Punkt orientacyjny ma geometrię przestrzenną, a cel znajduje się w jej granicach.
BESIDE Cel znajduje się bezpośrednio obok punktu orientacyjnego.
ACROSS_THE_ROAD Punkt docelowy znajduje się naprzeciwko punktu orientacyjnego po drugiej stronie drogi.
DOWN_THE_ROAD na tej samej trasie co punkt orientacyjny, ale nie obok niego ani naprzeciwko;
AROUND_THE_CORNER Nie na tej samej trasie co punkt orientacyjny, ale w odległości jednej skrętki.
BEHIND w pobliżu budynku, ale z dala od wejść od strony ulicy;

AuthorAttribution

Informacje o autorze danych treści 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

Żądanie proto AutocompletePlaces.

Pola
input

string

Wymagany. Tekst, w którym ma być przeprowadzone wyszukiwanie.
location_bias

LocationBias

Opcjonalnie: Wyniki są przybliżone do określonej lokalizacji.

Maksymalnie jeden z tych parametrów: location_bias lub location_restriction powinien być ustawiony. Jeśli żaden z tych parametrów nie zostanie ustawiony, wyniki będą obarczone błędem wynikającym z adresu IP, co oznacza, że adres IP zostanie zmapowany na nieprecyzyjną lokalizację i użyty jako sygnał zastępczy.
location_restriction

LocationRestriction

Opcjonalnie: Ogranicz wyniki do określonej lokalizacji.

Maksymalnie jeden z tych parametrów: location_bias lub location_restriction powinien być ustawiony. Jeśli żaden z tych parametrów nie zostanie ustawiony, wyniki będą obarczone błędem wynikającym z adresu IP, co oznacza, że adres IP zostanie zmapowany na nieprecyzyjną lokalizację i użyty jako sygnał zastępczy.
included_primary_types[]

string

Opcjonalnie: Uwzględnij podstawowy typ Miejsca (np. „restaurant” lub „gas_station”) w typach 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 podstawowy typ znajduje się na tej liście. Możesz podać maksymalnie 5 wartości. Jeśli nie podasz żadnych typów, zwrócone zostaną wszystkie typy miejsc.
included_region_codes[]

string

Opcjonalnie: Uwzględniaj tylko wyniki z określonych regionów, które są określone jako maksymalnie 15-cyfrowe kody regionów CLDR. Pusty zbiór nie ograniczy wyników. Jeśli ustawisz zarówno parametr location_restriction, jak i included_region_codes, wyniki będą znajdować się w obszarze ich przecięcia.
language_code

string

Opcjonalnie: Język, w którym mają być zwracane wyniki. Domyślna wartość to en-US. Wyniki mogą być podane w różnych językach, jeśli język używany 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 language_code.
region_code

string

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

LatLng

Opcjonalnie: Punkt początkowy, z którego ma być obliczona odległość geodezyjna do punktu docelowego (zwracana jako distance_meters). Jeśli ta wartość zostanie pominięta, odległość geodezyjna nie zostanie zwrócona.
input_offset

int32

Opcjonalnie: Odsunięcie znaku Unicode o wartość input liczone od 0, wskazujące pozycję kursora w elementach input. Pozycja kursora może wpływać na prognozy zwracane przez model.

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

bool

Opcjonalnie: Jeśli wartość to prawda, odpowiedź będzie zawierać zarówno prognozy dotyczące Miejsca, jak i zapytania. W przeciwnym razie odpowiedź zwróci tylko prognozy dotyczące miejsc.
session_token

string

Opcjonalnie: Ciąg tekstowy identyfikujący sesję Autouzupełniania na potrzeby rozliczeń. Musi być bezpiecznym ciągiem znaków w formacie 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 zacznie wpisywać zapytanie, a kończy, gdy wybierze miejsce i wywoła szczegóły miejsca lub weryfikację adresu. Każda sesja może zawierać wiele zapytań, po których następuje jedno żądanie dotyczące szczegółów miejsca docelowego lub weryfikacji adresu. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. Po zakończeniu sesji token nie jest już ważny. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli pominiesz parametr session_token lub użyjesz ponownie tokenu sesji, sesja zostanie obciążona opłatą tak, jakby nie podano tokenu sesji (każda prośba jest rozliczana osobno).

Zalecamy przestrzeganie tych wskazówek:

  • Używaj tokenów sesji we wszystkich wywołaniach autouzupełniania w Google Places.
  • generować nowy token dla każdej sesji; Zalecamy używanie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane do wszystkich żądań autouzupełniania, szczegółów miejsca i weryfikacji adresu w ramach sesji należą do tego samego projektu w Cloud Console.
  • Pamiętaj, aby w przypadku każdej nowej sesji przekazać unikalny token sesji. Użycie tego samego tokena w więcej niż 1 sesji spowoduje, że za każde żądanie zostanie naliczona osobna opłata.
include_pure_service_area_businesses

bool

Opcjonalnie: Uwzględnij firmy działające tylko na określonym obszarze, jeśli pole zawiera wartość true. Firma działająca 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. Firmy te nie mają adresu fizycznego ani lokalizacji w Mapach Google. W przypadku tych firm Places nie zwróci pól location, plus_code ani innych pól związanych z lokalizacją.

LocationBias

Region wyszukiwania. Wyniki mogą być stronnicze w przypadku regionu, którego dotyczyły.

Pola

Pole unii type.

type może być tylko jednym z tych elementów:
rectangle

Viewport

Widok definiowany przez narożnik północno-wschodni i narożnik południowo-zachodni.
circle

Circle

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

LocationRestriction

Region wyszukiwania. Wyniki zostaną ograniczone do wybranego regionu.

Pola

Pole unii type.

type może być tylko jednym z tych elementów:
rectangle

Viewport

Widok definiowany przez narożnik północno-wschodni i narożnik południowo-zachodni.
circle

Circle

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

AutocompletePlacesResponse

Protokół odpowiedzi dla AutocompletePlaces.

Pola
suggestions[]

Suggestion

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

Sugestia

Wynik sugestii autouzupełniania.

Pola

Pole unii kind.

kind może być tylko jednym z tych elementów:
place_prediction

PlacePrediction

Prognoza dotycząca miejsca.
query_prediction

QueryPrediction

Prognoza dla zapytania.

FormattableText

Tekst przedstawiający prognozę Miejsca lub zapytania. Tekst może być użyty w takiej postaci lub sformatowany.

Pola
text

string

Tekst, który można użyć w takiej postaci lub sformatowany za pomocą matches.
matches[]

StringRange

Lista zakresów ciągów tekstowych określająca, w których miejscach żądanie wejściowe pasuje do ciągu text. Za ich pomocą możesz sformatować określone części wyrażenia text. Podciągi podrzędne mogą nie być dopasowaniami ścisłymi do input, jeśli dopasowanie zostało określone na podstawie kryteriów innych niż dopasowanie ciągu znaków (np. poprawki ortograficzne lub transliteracje).

Te wartości to przesunięcie znaku Unicode o wartość text. Zakresy są zawsze sortowane według rosnących wartości przesunięcia.

PlacePrediction

Wyniki prognozy dla podpowiedzi autouzupełniania Miejsce.

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. Można go 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 obiektów jest to zwykle nazwa i adres firmy.

text jest zalecana dla programistów, którzy chcą wyświetlać pojedynczy element interfejsu. Deweloperzy, którzy chcą wyświetlać 2 oddzielne, ale powiązane elementy interfejsu, mogą zamiast tego użyć structured_format. Są to 2 różne sposoby przedstawiania prognozy miejsca. Użytkownicy nie powinni próbować przekształcać structured_format w text ani odwrotnie.

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

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

StructuredFormat

Podział przewidywanej lokalizacji na tekst główny zawierający nazwę lokalizacji i tekst dodatkowy z dodatkowymi funkcjami rozróżniającymi (np. miasto lub region).

structured_format jest zalecana dla deweloperów, którzy chcą wyświetlać 2 oddzielne, ale powiązane elementy interfejsu. Deweloperzy, którzy chcą wyświetlić pojedynczy element interfejsu, mogą użyć elementu text. Są to 2 różne sposoby przedstawiania prognozy miejsca. Użytkownicy nie powinni próbować przekształcać structured_format w text ani odwrotnie.
types[]

string

Lista typów, które dotyczą 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 tych samych typach mają podobne cechy.
distance_meters

int32

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

QueryPrediction

Wyniki prognozy dla podpowiedzi autouzupełniania zapytań.

Pola
text

FormattableText

Przewidziany tekst. Ten tekst nie reprezentuje Miejsca, ale zapytanie tekstowe, które może być użyte w punkcie końcowym wyszukiwania (np. wyszukiwaniu tekstowym).

text jest zalecana dla programistów, którzy chcą wyświetlać pojedynczy element interfejsu. Deweloperzy, którzy chcą wyświetlać 2 oddzielne, 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 odwrotnie.

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

StructuredFormat

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

structured_format jest zalecana dla deweloperów, którzy chcą wyświetlać 2 oddzielne, ale powiązane elementy interfejsu. Deweloperzy, którzy chcą wyświetlić pojedynczy element interfejsu, mogą 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 odwrotnie.

StringRange

Wyznacza podciąg w danym tekście.

Pola
start_offset

int32

Odsunięcie pierwszego znaku Unicode w ciągu liczone od 0 (włącznie).
end_offset

int32

Odsunięcie ostatniego znaku Unicode (nie wliczając go) liczone od zera.

StructuredFormat

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

W przypadku przewidywanej lokalizacji tekst główny zawiera nazwę tej lokalizacji. W przypadku prognoz zapytań tekst główny zawiera zapytanie.

Tekst dodatkowy zawiera dodatkowe funkcje rozróżniania (np. miasto lub region), które umożliwiają dokładniejsze zidentyfikowanie Miejsca lub doprecyzowanie zapytania.

Pola
main_text

FormattableText

Reprezentuje nazwę Miejsca lub zapytania.
secondary_text

FormattableText

Reprezentują dodatkowe cechy rozróżniające (np. miasto lub region), które umożliwiają dokładniejsze zidentyfikowanie Miejsca lub doprecyzowanie zapytania.

Okrąg

Okrąg z LatLng jako środkiem i promieniem.

Pola
center

LatLng

Wymagany. Szerokość i długość geograficzna pośrodku.

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

double

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

ContentBlock

Blok treści, który może być wyświetlany osobno.

Pola
topic

string

Temat treści, np. „przegląd” lub „restauracja”.
content

LocalizedText

treści związane z tematem,
references

References

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

Odwołania powiązane z tym blokiem treści.

ContextualContent

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

Treści kontekstowe związane z zapytaniem o miejsce.

Pola
reviews[]

Review

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

Photo

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

Justification

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

uzasadnienie dotyczące miejsca;

Uzasadnienie

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

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

Pola

Pole unii justification.

justification może być tylko jednym z tych elementów:
review_justification

ReviewJustification

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

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributesJustification

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Uzasadnienia atrybutów BusinessAvailabilityAttributes. Pokazuje ona atrybuty firmy, które mogą zainteresować użytkownika końcowego.

Pola
takeout

bool

czy miejsce oferuje jedzenie na wynos.
delivery

bool

czy miejsce oferuje dostawę.
dine_in

bool

czy w danym miejscu można zjeść posiłek;

ReviewJustification

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

uzasadnienia opinii użytkowników; To wyróżnia sekcję opinii użytkownika, która może zainteresować użytkownika końcowego. Jeśli na przykład wyszukiwane hasło to „pizza z drewna opałowego”, uzasadnienie opinii wyróżnia tekst odnoszący się do wyszukiwanego hasła.

Pola
highlighted_text

HighlightedText
review

Review

Opinia, na podstawie której wygenerowano podświetlony tekst.

HighlightedText

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

Pola
text

string
highlighted_text_ranges[]

HighlightedTextRange

Lista zakresów zaznaczonego tekstu.

HighlightedTextRange

Zakres wyróżnionego tekstu.

Pola
start_index

int32
end_index

int32

EVChargeOptions

informacje o stacji ładowania EV hostowanej w miejscu; Terminologia zgodna z https://afdc.energy.gov/fuels/electricity_infrastructure.html Jeden port może ładować tylko jeden samochód naraz. Jeden port ma co najmniej 1 złącze. Jedna stacja ma co najmniej 1 port.

Pola
connector_count

int32

Liczba złączy w tej stacji. Jednak ponieważ niektóre porty mogą mieć kilka wtyczek, ale jednocześnie ładować tylko jeden samochód (np.), liczba wtyczek może być większa niż łączna liczba samochodów, które mogą ładować się jednocześnie.
connector_aggregation[]

ConnectorAggregation

Lista agregacji złącza do ładowania pojazdów elektrycznych, które zawiera 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 agregację ładowania EV dla złącz, które mają ten sam typ i maksymalny współczynnik ładowania w kW.

Pola
type

EVConnectorType

Typ łącznika tej agregacji.
max_charge_rate_kw

double

Stałe maksymalne stawki opłat w kW każdego z połączeń w danych agregacji.
count

int32

Liczba wtyczek w tym agregacie.
availability_last_update_time

Timestamp

Sygnatura czasowa określająca, kiedy informacje o dostępności usługi łącznika w tym agregacie zostały ostatnio zaktualizowane.
available_count

int32

Liczba obecnie dostępnych w tej agregacji konwerterów.
out_of_service_count

int32

Liczba komponentów w tym agregacie, 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 złącze.
EV_CONNECTOR_TYPE_OTHER Inne typy łączników.
EV_CONNECTOR_TYPE_J1772 Złącze J1772 typu 1.
EV_CONNECTOR_TYPE_TYPE_2 Złącze IEC 62196 typu 2. Często określany jako MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Wtyczka typu CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (CCS) (system ładowania mieszanego, prąd przemienny i stały). Na podstawie SAE. Złącze typu 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (CCS) (system ładowania mieszanego, prąd przemienny i stały). Na podstawie złącza Mennekes typu 2
EV_CONNECTOR_TYPE_TESLA Ogólne oprogramowanie sprzęgające TESLA. Jest to standard NACS w Ameryce Północnej, ale w innych częściach świata może być inny (np. CCS Combo 2 (CCS2) lub GB/T). Ta wartość nie odzwierciedla tak bardzo rzeczywistego typu złącza, ale raczej możliwość ładowania pojazdu marki Tesla na stacji ładowania należącej do Tesli.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Typ GB/T odpowiada chińskiemu standardowi GB/T. Ten typ obejmuje wszystkie typy GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Nieokreślone gniazdko ścienne.
EV_CONNECTOR_TYPE_NACS Północnoamerykański system ładowania (NACS) oparty na standardzie SAE J3400.

FuelOptions

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

Pola
fuel_prices[]

FuelPrice

Ostatnia znana cena paliwa dla każdego rodzaju paliwa dostępnego na tej stacji. Na stacji jest jeden wpis na każdy rodzaj paliwa. Kolejność nie ma znaczenia.

FuelPrice

informacje o cenie paliwa dla danego typu;

Pola
type

FuelType

Typ paliwa.
price

Money

Cena paliwa.
update_time

Timestamp

Czas ostatniej aktualizacji ceny paliwa.

FuelType

Rodzaje paliwa.

Wartości w polu enum
FUEL_TYPE_UNSPECIFIED Nieokreślony typ paliwa.
DIESEL olej napędowy,
DIESEL_PLUS Diesel plus fuel.
REGULAR_UNLEADED Bezołowiowa bezołowiowa.
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 Liquefied Petroleum Gas.
E80 E 80.
E85 E 85.
E100 E 100.
METHANE metan,
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Ciężarówka z dieslem.

GetPhotoMediaRequest

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

Pola
name

string

Wymagany. Nazwa zasobu z multimediów fotograficznych w formacie: places/{place_id}/photos/{photo_reference}/media.

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

int32

Opcjonalnie: Określa maksymalną oczekiwaną szerokość obrazu (w pikselach). Jeśli obraz jest mniejszy niż określone wartości, zwrócony zostanie obraz oryginalny. Jeśli obraz jest większy w jednym z wymiarów, zostanie on dostosowany do mniejszego wymiaru, zachowując oryginalny format obrazu. 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 właściwości: max_height_px lub max_width_px. Jeśli nie określono ani argumentu max_height_px, ani argumentu max_width_px, zwrócony zostanie błąd INVALID_ARGUMENT.
max_height_px

int32

Opcjonalnie: Określa maksymalną wysokość obrazu (w pikselach). Jeśli obraz jest mniejszy niż określone wartości, zwrócony zostanie obraz oryginalny. Jeśli obraz jest większy w jednym z wymiarów, zostanie on dostosowany do mniejszego wymiaru, zachowując oryginalny format obrazu. 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 właściwości: max_height_px lub max_width_px. Jeśli nie określono ani argumentu max_height_px, ani argumentu max_width_px, zwrócony zostanie błąd INVALID_ARGUMENT.
skip_http_redirect

bool

Opcjonalnie: Jeśli to ustawienie jest ustawione, pomiń domyślne zachowanie przekierowania HTTP i wyświetlaj odpowiedź w formacie tekstowym (np. w formacie JSON w przypadku HTTP). Jeśli nie zostanie ustawiony, zostanie wydane przekierowanie HTTP, aby przekierować wywołanie do multimediów z obrazem. Ta opcja jest ignorowana w przypadku żądań innych niż HTTP.

GetPlaceRequest

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

Pola
name

string

Wymagany. 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 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ępny). Parametr może wpływać na wyniki w zależności od obowiązujących przepisów. 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 identyfikujący sesję Autouzupełniania na potrzeby rozliczeń. Musi być bezpiecznym ciągiem znaków w formacie 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 zacznie wpisywać zapytanie, a kończy, gdy wybierze miejsce i wywoła szczegóły miejsca lub weryfikację adresu. Każda sesja może zawierać wiele zapytań, po których następuje jedno żądanie dotyczące szczegółów miejsca docelowego lub weryfikacji adresu. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. Po zakończeniu sesji token nie jest już ważny. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli pominiesz parametr session_token lub użyjesz ponownie tokenu sesji, sesja zostanie obciążona opłatą tak, jakby nie podano tokenu sesji (każda prośba jest rozliczana osobno).

Zalecamy przestrzeganie tych wskazówek:

  • Używaj tokenów sesji we wszystkich wywołaniach autouzupełniania w Google Places.
  • generować nowy token dla każdej sesji; Zalecamy używanie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane do wszystkich żądań autouzupełniania, szczegółów miejsca i weryfikacji adresu w ramach sesji należą do tego samego projektu w Cloud Console.
  • Pamiętaj, aby w przypadku każdej nowej sesji przekazać unikalny token sesji. Użycie tego samego tokena w więcej niż 1 sesji spowoduje, że za każde żądanie zostanie naliczona osobna opłata.

Zdjęcie

Informacje o zdjęciu miejsca.

Pola
name

string

Identyfikator. Odniesienie do zdjęcia tego miejsca, które może służyć do ponownego wyszukiwania tego zdjęcia (nazwa „zasobu” interfejsu 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 z zdjęciem.
google_maps_uri

string

link do zdjęcia w Mapach Google;

PhotoMedia

Media z interfejsu Places API.

Pola
name

string

Nazwa zasobu z multimediów fotograficznych w formacie: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

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

Miejsce

Wszystkie informacje dotyczące Miejsca.

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 służyć jako krótki opis zrozumiały dla człowieka. Na przykład „Google Sydney”, „Starbucks”, „Pyrmont” itp.
types[]

string

Zestaw tagów typu dla tego wyniku. Na przykład „polityka” i „miejscowość”. 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 obsługiwanych typów interfejsu Places API. Na przykład „restauracja”, „kawiarnia”, „lotnisko” itp. Miejsce może mieć tylko jeden podstawowy typ. 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_display_name

LocalizedText

Wyświetlana nazwa głównego typu, zlokalizowana w języku żądania (w stosownych przypadkach). 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.
national_phone_number

string

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

string

Zrozumiały dla człowieka numer telefonu do miejsca w formacie międzynarodowym.
formatted_address

string

Pełny adres tego miejsca w zrozumiałej dla człowieka formie.
short_formatted_address

string

Krótki adres zrozumiały dla człowieka.
address_components[]

AddressComponent

powtarzane komponenty na każdym poziomie lokalizacji; Uwaga: zbiór elementów adresu może zawierać więcej elementów niż zbiór formatted_address. – tablica niekoniecznie zawiera wszystkie podmioty polityczne, które zawierają adres, poza tymi, które są uwzględnione w tablicy formatted_address. Aby pobrać wszystkie jednostki polityczne zawierające określony adres, użyj odwrotnego geokodowania, przekazując szerokość/długość geograficzną adresu jako parametr żądania. – nie ma gwarancji, że format odpowiedzi będzie taki sam w przypadku różnych żądań. W szczególności liczba elementów address_components zależy od adresu, którego dotyczy żądanie, i może się zmienić w czasie w przypadku tego samego adresu. Element 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ść/długość geograficzna).
location

LatLng

Pozycja tego miejsca.
viewport

Viewport

Widok, który umożliwia wyświetlanie miejsca na mapie o średnim rozmiarze. Widok nie powinien być używany jako granica fizyczna ani obszar świadczenia usług firmy.
rating

double

Ocena od 1,0 do 5,0 na podstawie opinii użytkowników dotyczących tego miejsca.
google_maps_uri

string

Adres URL prowadzący do strony z większą ilością informacji o tym miejscu.
website_uri

string

Witryna internetowa z autorytatywnymi informacjami o danym miejscu, np. strona główna firmy. Pamiętaj, że w przypadku miejsc należących do sieci (np. sklepu IKEA) zwykle będzie to witryna konkretnego sklepu, a nie całej sieci.
reviews[]

Review

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

OpeningHours

standardowe godziny otwarcia; Pamiętaj, że jeśli miejsce jest zawsze otwarte (24 godziny), pole close nie zostanie ustawione. Klienci mogą polegać na tym, że zawsze otwarte (24 godziny) jest reprezentowane jako okres [open][google.maps.places.v1.Place.OpeningHours.Period.open] zawierający [day][Point.day] o wartości 0, [hour][Point.hour] o wartości 0 i [minute][Point.minute] o wartości 0.
time_zone

TimeZone

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

Photo

Informacje (w tym odniesienia) o zdjęciach tego miejsca. Maksymalnie można zwrócić 10 zdjęć.
adr_format_address

string

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

BusinessStatus

Stan firmy w danym miejscu.
price_level

PriceLevel

Poziom cen w danym miejscu.
attributions[]

Attribution

Zestaw dostawcy danych, który musi być wyświetlany z tym wynikiem.
icon_mask_base_uri

string

Obcięty URL maski ikony. Użytkownik może uzyskać dostęp do innego typu ikony, dodając do niego sufiks typu (np. „.svg” lub „.png”).
icon_background_color

string

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

OpeningHours

godziny otwarcia na kolejne 7 dni (w tym dzisiejsze); Okres ten rozpoczyna się o północy w dniu wysłania prośby i kończy o 23:59 w dniu 6 dni później. To pole zawiera podpole special_days wszystkich godzin, które są ustawione na dni z niestandardowymi godzinami otwarcia.
current_secondary_opening_hours[]

OpeningHours

Zawiera tablicę wpisów na najbliższe 7 dni, w tym informacje o dodatkowych godzinach otwarcia firmy. Te godziny różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może podać jako godziny dodatkowe godziny otwarcia okienka drive-thru lub godziny dostawy. To pole wypełnia podpole typu, które korzysta z wstępnie zdefiniowanej listy typów godzin otwarcia (np. DRIVE_THROUGH, PICKUP lub TAKEOUT) na podstawie typów miejsc. To pole zawiera podpole special_days wszystkich godzin, które są ustawione na dni z niestandardowymi godzinami otwarcia.
regular_secondary_opening_hours[]

OpeningHours

Zawiera tablicę wpisów z informacjami o zwykłych godzinach otwarcia firmy. Te godziny różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może podać jako godziny dodatkowe godziny otwarcia okienka drive-thru lub godziny dostawy. To pole wypełnia podpole typu, które korzysta z wstępnie zdefiniowanej listy typów godzin otwarcia (np. DRIVE_THROUGH, PICKUP lub TAKEOUT) na podstawie typów miejsc.
editorial_summary

LocalizedText

Zawiera podsumowanie informacji o miejscu. Podsumowanie zawiera tekstowy przegląd i kod języka (jeśli dotyczy). Tekst podsumowania musi być przedstawiony w postaci oryginalnej i nie można go modyfikować ani zmieniać.
payment_options

PaymentOptions

opcje płatności akceptowane przez daną firmę; Jeśli dane opcji płatności są niedostępne, pole opcji płatności nie będzie ustawione.
parking_options

ParkingOptions

Opcje parkowania oferowane przez miejsce.
sub_destinations[]

SubDestination

Lista podmiejsc docelowych powiązanych z danym miejscem.
fuel_options

FuelOptions

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

EVChargeOptions

Informacje o opcjach ładowania pojazdów elektrycznych.
generative_summary

GenerativeSummary

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

Podsumowanie miejsca wygenerowane przez AI.
area_summary

AreaSummary

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

Podsumowanie wygenerowane przez AI dotyczące obszaru, na którym znajduje się dane miejsce.
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 opisu adresu znajdziesz na stronie https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
price_range

PriceRange

Zakres cen powiązany z miejscem.
utc_offset_minutes

int32

Liczba minut, o którą strefa czasowa tego miejsca jest przesunięta względem UTC. Jest on wyrażany 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 w pomieszczeniu czy na zewnątrz.
curbside_pickup

bool

Określa, czy firma obsługuje odbiór z ulicy.
reservable

bool

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

bool

Określa, czy w danym miejscu serwowane jest śniadanie.
serves_lunch

bool

Określa, czy miejsce serwuje obiady.
serves_dinner

bool

Określa, czy miejsce serwuje kolacje.
serves_beer

bool

Określa, czy w danym miejscu serwowane jest piwo.
serves_wine

bool

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

bool

Określa, czy miejsce serwuje brunch.
serves_vegetarian_food

bool

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

bool

Miejsce oferuje miejsca do siedzenia na świeżym powietrzu.
live_music

bool

Miejsce oferuje muzykę na żywo.
menu_for_children

bool

Miejsce ma menu dla dzieci.
serves_cocktails

bool

Miejsce serwuje koktajle.
serves_dessert

bool

Miejsce serwuje desery.
serves_coffee

bool

Miejsce serwuje kawę.
good_for_children

bool

Miejsce jest dobre dla dzieci.
allows_dogs

bool

Miejsce, w którym można wejść z psem.
restroom

bool

Miejsce ma toaletę.
good_for_groups

bool

Miejsce dostosowane do grup.
good_for_watching_sports

bool

Miejsce nadaje się do oglądania sportu.
accessibility_options

AccessibilityOptions

informacje o opcjach ułatwień dostępu oferowanych przez dane miejsce;
pure_service_area_business

bool

Wskazuje, czy dane miejsce jest miejscem świadczenia usług. Firma działająca 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. Firmy te mogą nie mieć adresu fizycznego ani lokalizacji w Mapach Google.

AccessibilityOptions

informacje o opcjach ułatwień dostępu oferowanych przez dane miejsce;

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

Toaleta jest dostępna dla osób na wózkach.
wheelchair_accessible_seating

bool

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

AddressComponent

Uporządkowane komponenty, które tworzą sformatowany adres, jeśli te informacje są dostępne.

Pola
long_text

string

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

string

Skrócona nazwa tekstowa elementu adresu (jeśli jest dostępna). Na przykład element adresu dla kraju Australia może mieć wartość short_name „AU”.
types[]

string

Tablica wskazująca typy komponentu adresu.
language_code

string

Język używany do formatowania tych komponentów w notacji CLDR.

AreaSummary

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

Podsumowanie wygenerowane przez AI dotyczące obszaru, na którym znajduje się dane miejsce.

Pola
content_blocks[]

ContentBlock

Bloki treści, z których składa się podsumowanie obszaru. Każdy blok dotyczy osobnego tematu dotyczącego danego obszaru.
flag_content_uri

string

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

Atrybucja

Informacje o dostawcach danych dotyczących tego miejsca.

Pola
provider

string

Nazwa dostawcy danych Miejsca.
provider_uri

string

Identyfikator URI dostawcy danych miejsca.

BusinessStatus

Stan firmy w danym miejscu.

Wartości w polu enum
BUSINESS_STATUS_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
OPERATIONAL Obiekt jest czynny, ale niekoniecznie otwarty.
CLOSED_TEMPORARILY Obiekt jest tymczasowo zamknięty.
CLOSED_PERMANENTLY Obiekt został zamknięty na stałe.

ContainingPlace

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

Pola
name

string

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

string

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

GenerativeSummary

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

Podsumowanie miejsca wygenerowane przez AI.

Pola
overview

LocalizedText

Omówienie miejsca.
overview_flag_content_uri

string

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

LocalizedText

Szczegółowy opis miejsca.
description_flag_content_uri

string

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

References

Odniesienia służące do generowania opisu podsumowania.

OpeningHours

Informacje o godzinach otwarcia miejsca.

Pola
periods[]

Period

Godziny otwarcia tego miejsca w ciągu tygodnia. Okresy są podawane w porządku chronologicznym, zaczynając od niedzieli w strefie czasowej danego miejsca. Pustą (ale nie nieobecną) wartość można użyć, aby wskazać miejsce, które nigdy nie jest otwarte, np. z powodu tymczasowego zamknięcia na czas remontu.
weekday_descriptions[]

string

Lokalizowane ciągi tekstowe opisujące godziny otwarcia tego miejsca, po jednym ciągu na każdy dzień tygodnia. Będzie pusty, jeśli godziny są nieznane lub nie udało się ich przekonwertować na tekst zlokalizowany. Przykład: „Niedziela: 18:00–6:00”
secondary_hours_type

SecondaryHoursType

Ciąg tekstowy służący do identyfikowania typu godzin dodatkowych.
special_days[]

SpecialDay

Uporządkowane informacje o dniach specjalnych, które przypadają w okresie objętym zwróconymi godzinami otwarcia. Dni specjalne to dni, które mogą mieć wpływ na godziny otwarcia danego miejsca, np. Boże Narodzenie. Ustaw w przypadku current_opening_hours i current_secondary_opening_hours, jeśli występują godziny szczególne.
next_open_time

Timestamp

Następny czas rozpoczęcia bieżących godzin otwarcia może być ustawiony na okres do 7 dni w przyszłości. To pole jest wypełniane tylko wtedy, gdy w momencie obsługi żądania godziny otwarcia nie są aktywne.
next_close_time

Timestamp

Czas zakończenia bieżącego okresu godzin otwarcia (do 7 dni w przyszłości). To pole jest wypełniane tylko wtedy, gdy w momencie obsługi żądania godziny otwarcia są aktywne.
open_now

bool

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

Okres

Okres, w którym miejsce ma stan open_now.

Pola
open

Point

Godzina otwarcia miejsca.
close

Point

Czas, od którego miejsce jest zamknięte.

Punkt

Punkty zmiany stanu.

Pola
date

Date

Data w lokalnej strefie czasowej miejsca.
truncated

bool

Określa, czy ten punkt końcowy został obcięty. Obcinanie występuje, gdy rzeczywiste godziny wykraczają poza zakres godzin, które chcemy zwrócić, więc skracamy je do tych granic. Dzięki temu maksymalnie 24 x 7 godzin od północy w dniu wysłania prośby zostaną zwrócone.
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. Ma zakres od 0 do 59.

SecondaryHoursType

Typ służący do identyfikowania typu godzin dodatkowych.

Wartości w polu enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Wartość domyślna, gdy nie jest określony typ godzin wtórnych.
DRIVE_THROUGH Godzina, w której banki, restauracje i apteki są otwarte dla klientów, którzy chcą skorzystać z usługi drive-through.
HAPPY_HOUR Happy hours.
DELIVERY Godzina dostawy.
TAKEOUT Godzina odbioru na wynos.
KITCHEN Czas na gotowanie.
BREAKFAST Czas na śniadanie.
LUNCH W godzinę lunchową.
DINNER Obiad.
BRUNCH Godzina brunchu.
PICKUP Godzina odbioru.
ACCESS Godziny dostępu do miejsc przechowywania.
SENIOR_HOURS specjalne godziny dla seniorów;
ONLINE_SERVICE_HOURS Godziny otwarcia online.

SpecialDay

Uporządkowane informacje o dniach specjalnych, które przypadają w okresie objętym zwróconymi godzinami otwarcia. Dni specjalne to dni, które mogą mieć wpływ na godziny otwarcia danego 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ż 1 opcję jednocześnie.

Pola
free_parking_lot

bool

Miejsce oferuje bezpłatne parkingi.
paid_parking_lot

bool

Miejsce oferuje płatne parkingi.
free_street_parking

bool

Obiekt oferuje bezpłatny parking na ulicy.
paid_street_parking

bool

Miejsce oferuje płatny parking przy ulicy.
valet_parking

bool

Miejsce oferuje parking z obsługą.
free_garage_parking

bool

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

bool

Miejsce oferuje płatny parking w garażu.

PaymentOptions

opcje płatności akceptowane przez daną firmę;

Pola
accepts_credit_cards

bool

Miejsce akceptuje płatności kartą kredytową.
accepts_debit_cards

bool

Miejsce akceptuje płatności kartami debetowymi.
accepts_cash_only

bool

Miejsce akceptuje 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

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

Pola
global_code

string

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

string

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

SubDestination

Podmiejsca docelowe to konkretne miejsca powiązane z miejscem głównym. Te opcje zapewniają bardziej szczegółowe miejsca docelowe dla użytkowników, którzy szukają dużych lub złożonych miejsc, takich jak lotnisko, park narodowy, uniwersytet czy stadion. Na przykład podmiejsca na lotnisku mogą obejmować powiązane terminale i parkingi. Podrzędne miejsca docelowe zwracają identyfikator miejsca i nazwa zasobu miejsca, które można wykorzystać w kolejnych żądaniach Szczegóły miejsca (Nowe), aby pobrać bardziej szczegółowe informacje, w tym nazwę wyświetlaną i lokalizację podrzędnego miejsca docelowego.

Pola
name

string

Nazwa zasobu podrzędnego miejsca docelowego.
id

string

Identyfikator miejsca docelowego.

Linia łamana

Linia łamana trasy. Obsługuje tylko zakodowaną wielolinię, która może być przekazywana jako ciąg znaków i zawiera kompresję z minimalną utratą jakości. To jest domyślny wynik interfejsu Routes API.

Pola
Pole unii polyline_type. Zawiera typ linii łamany. Domyślne dane wyjściowe interfejsu Routes API to encoded_polyline. polyline_type może być tylko jednym z tych elementów:
encoded_polyline

string

Zakodowana linia łamana zwrócona domyślnie przez interfejs API Trasy. Zapoznaj się z narzędziami kodowania i dekodowania.

PriceLevel

Poziom cen w danym miejscu.

Wartości w polu enum
PRICE_LEVEL_UNSPECIFIED Poziom ceny miejsca 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 rozsądnych 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. Wartość 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 zakresu cen (włącznie). Cena powinna być równa tej kwocie lub wyższa.
end_price

Money

Górna granica przedziału cenowego (nie wliczając go). Cena powinna być niższa od tej kwoty.

Odniesienia

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

Odniesienie do treści generatywnych.

Pola
reviews[]

Review

opinie, które służą jako odniesienia;
places[]

string

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

Sprawdź

Informacje o opinii o miejscu.

Pola
name

string

Odniesienie do oceny miejsca, które może służyć do ponownego wyszukiwania tej oceny (nazwa „zasobu” interfejsu API: places/{place_id}/reviews/{review}).
relative_publish_time_description

string

Formatowany ciąg znaków zawierający czas, w którym została napisana opinia, wyrażony 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 1,0–5,0, zwana też liczbą gwiazdek.
author_attribution

AuthorAttribution

Imię i nazwisko autora 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.

RouteModifiers

Zawiera zestaw opcjonalnych warunków, które należy spełnić podczas obliczania tras.

Pola
avoid_tolls

bool

Opcjonalnie: Gdy ta opcja jest ustawiona na wartość true (prawda), omijanie dróg płatnych, jeśli to możliwe, na rzecz tras nieobejmujących dróg płatnych. Dotyczy tylko znaczników DRIVE i TWO_WHEELER TravelMode.
avoid_highways

bool

Opcjonalnie: Jeśli ustawisz wartość prawda, aplikacja będzie unikać autostrad, jeśli to możliwe, preferując trasy bez autostrad. Dotyczy tylko znaczników DRIVE i TWO_WHEELER TravelMode.
avoid_ferries

bool

Opcjonalnie: Jeśli ta opcja jest ustawiona na wartość prawda, w uzasadnionych przypadkach unikaj promów, preferując trasy bez promów. Dotyczy tylko znaczników DRIVE i TWO_WHEELER TravelMode.
avoid_indoor

bool

Opcjonalnie: Jeśli ustawisz wartość prawda, unikaj nawigacji w pomieszczeniach, jeśli to możliwe, preferując trasy bez nawigacji wewnątrz budynków. Dotyczy tylko WALK TravelMode.

RoutingParameters

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

Pola
origin

LatLng

Opcjonalnie: Wyraźne źródło routingu, które zastępuje źródło zdefiniowane w wielokącie. Domyślnie używany jest początek ścieżki wielopunktowej.
travel_mode

TravelMode

Opcjonalnie: Tryb podróży.
route_modifiers

RouteModifiers

Opcjonalnie: Modyfikatory trasy.
routing_preference

RoutingPreference

Opcjonalnie: Określa sposób obliczania podsumowań routingu. Serwer próbuje użyć wybranych preferencji routingu do obliczenia trasy. Ustawienie routingu uwzględniającego natężenie ruchu jest dostępne tylko w przypadku DRIVE lub TWO_WHEELER travelMode.

RoutingPreference

Zestaw wartości określających czynniki, które należy wziąć pod uwagę podczas obliczania trasy.

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji routingu. Domyślnie TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania rzeczywistych warunków na drodze. Odpowiedni, gdy warunki na drodze nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości powoduje najniższe opóźnienie. Uwaga: w przypadku TravelMode DRIVE i TWO_WHEELER wybrana trasa i czas trwania są określane na podstawie sieci drogowej i średnich warunków ruchu niezależnie od pory dnia, a nie aktualnych warunków na drodze. W związku z tym trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki dla danego żądania mogą się zmieniać w czasie z powodu zmian w sieci drogowej, zaktualizowanych średnich warunków ruchu i rozproszonej natury usługi. Wyniki mogą się też różnić między niemal identycznymi trasami w dowolnym czasie lub częstotliwości.
TRAFFIC_AWARE oblicza trasy, biorąc pod uwagę aktualne warunki na drodze; W przeciwieństwie do TRAFFIC_AWARE_OPTIMAL, niektóre optymalizacje są stosowane w celu znacznego skrócenia opóźnień.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy, biorąc pod uwagę warunki ruchu drogowego w czasie rzeczywistym, bez stosowania większości optymalizacji skuteczności. Użycie tej wartości powoduje największe opóźnienie.

RoutingSummary

Czas i odległość od miejsca wyjazdu do miejsca docelowego w odpowiedzi oraz drugi etap od tego miejsca do miejsca docelowego (jeśli jest wymagany). Uwaga: dodanie parametru routingSummaries w masce pola bez uwzględnienia w żądaniu parametru routingParameters.origin lub searchAlongRouteParameters.polyline.encodedPolyline powoduje błąd.

Pola
legs[]

Leg

Etapy podróży.

Podczas obliczania czasu i odległości podróży z zadanego miejsca wyjazdu legs zawiera pojedynczy etap z czasem i odległością od miejsca wyjazdu do miejsca docelowego. Gdy szukasz informacji na trasie, legs zawiera 2 odcinki: jeden z miejsca wyjazdu do miejsca docelowego i jeden z miejsca docelowego do miejsca docelowego.
directions_uri

string

Link do wyświetlenia trasy w Mapach Google z użyciem punktów pośrednich z danego podsumowania wytyczania trasy. Nie ma gwarancji, że trasa wygenerowana przez to połączenie będzie taka sama jak trasa użyta do wygenerowania podsumowania routingu. Link korzysta z informacji podanych w prośbie, w tym z danych z polów routingParameters i searchAlongRouteParameters (w stosownych przypadkach), aby wygenerować link do wskazówek dojazdu.

Noga

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

Pola
duration

Duration

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

int32

Odległość na tym odcinku podróży.

SearchNearbyRequest

Prześlij protokół dotyczący wyszukiwania w pobliżu.

Pola
language_code

string

Szczegóły miejsca będą wyświetlane w preferowanym języku (jeśli jest dostępny). Jeśli kod języka nie jest określony lub nie jest rozpoznawany, 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ępny). Parametr może wpływać na wyniki w zależności od obowiązujących przepisów.

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ą jakieś sprzeczne typy, np. typ występuje zarówno w sekcji included_types, jak i 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"]}, zwracane miejsca oferują usługi związane z restauracją, ale nie działają głównie jako „restauracje”.
excluded_types[]

string

Wykluczony typ miejsca (np. „restaurant” lub „gas_station”) z witryny 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 podaje zarówno typy uwzględnione (np. restauracja), jak i wykluczone (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 included_types i żadnego z typów excluded_types.

Jeśli występują jakieś sprzeczne typy, np. typ występuje zarówno w sekcji included_types, jak i 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"]}, zwracane miejsca oferują usługi związane z restauracją, ale nie działają głównie jako „restauracje”.
included_primary_types[]

string

Uwzględniony podstawowy typ Miejsca (np. „restaurant” lub „gas_station”) z https://developers.google.com/maps/documentation/places/web-service/place-types. Miejsce może mieć tylko jeden podstawowy typ z powiązanej z nim tabeli obsługiwanych typów.

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

Jeśli występują jakieś sprzeczne typy podstawowe, np. typ występuje zarówno w kluczu included_primary_types, jak i w kluczu 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"]}, zwracane miejsca oferują usługi związane z restauracją, ale nie działają głównie jako „restauracje”.
excluded_primary_types[]

string

Wykluczony podstawowy 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ą jakieś sprzeczne typy podstawowe, np. typ występuje zarówno w kluczu included_primary_types, jak i w kluczu 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"]}, zwracane miejsca oferują usługi związane z restauracją, ale nie działają głównie jako „restauracje”.
max_result_count

int32

Maksymalna liczba wyników do zwrócenia. Musi zawierać się w zakresie od 1 do 20 (domyślnie) włącznie. Jeśli liczba nie jest ustawiona, jest używany górny limit. Jeśli liczba jest ujemna lub przekracza górny limit, zwracany jest błąd INVALID_ARGUMENT.
location_restriction

LocationRestriction

Wymagany. Region wyszukiwania.
rank_preference

RankPreference

sposób porządkowania wyników w odpowiedzi.
routing_parameters

RoutingParameters

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

LocationRestriction

Region wyszukiwania.

Pola

Pole unii type.

type może być tylko jednym z tych elementów:
circle

Circle

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

RankPreference

sposób porządkowania wyników w odpowiedzi.

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED Wartość RankPreference nie została ustawiona. Domyślnie będzie używane miejsce według popularności.
DISTANCE Ustawia wyniki według odległości.
POPULARITY Ustawia wyniki według popularności.

SearchNearbyResponse

Protokół odpowiedzi dla wyszukiwania w pobliżu.

Pola
places[]

Place

Lista miejsc spełniających wymagania użytkownika, np. typy miejsc, liczba miejsc i szczegółowe ograniczenia dotyczące lokalizacji.
routing_summaries[]

RoutingSummary

Lista podsumowań tras, w której każdy wpis jest powiązany z odpowiednim miejscem w tym samym indeksie w polu places. Jeśli podsumowanie trasy jest niedostępne dla jednego z miejsc, będzie zawierać pusty wpis. Ta lista powinna zawierać tyle pozycji, ile jest podanych w liście miejsc.

SearchTextRequest

Żądanie proto SearchText.

Pola
text_query

string

Wymagany. Zapytanie tekstowe w wyszukiwarce tekstowej.
language_code

string

Szczegóły miejsca będą wyświetlane w preferowanym języku (jeśli jest dostępny). Jeśli kod języka nie jest określony lub nie jest rozpoznawany, 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ępny). Parametr może wpływać na wyniki w zależności od obowiązujących przepisów.

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

sposób porządkowania wyników w odpowiedzi.
included_type

string

Wybrany typ miejsca. Pełna lista obsługiwanych typów: https://developers.google.com/maps/documentation/places/web-service/place-types. Obsługuje tylko jeden 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

Wyklucz wyniki, których średnia ocena użytkowników jest wyraźnie niższa od tego limitu. Prawidłowa wartość musi być liczbą zmiennoprzecinkową z zakresu od 0 do 5 (włącznie) z kadencem 0,5 tzn. [0, 0,5, 1,0, …, 5,0]. Podana ocena zostanie zaokrąglona w górę do najbliższej 0,5(górne zaokrąglenie). Na przykład ocena 0,6 spowoduje wyeliminowanie wszystkich wyników z oceną niższą niż 1,0.
max_result_count
(deprecated)

int32

Wycofane: użyj w zastępstwie tego page_size.

Maksymalna liczba wyników na stronę, które mogą zostać zwrócone. Jeśli liczba dostępnych wyników jest większa niż max_result_count, zwracany jest next_page_token, który można przekazać do page_token, aby uzyskać następną stronę wyników w kolejnych żądaniach. 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ą sformatowane na 20. Wartości ujemne zwracają błąd INVALID_ARGUMENT.

Jeśli podano 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 mogą zostać zwrócone. Jeśli liczba dostępnych wyników jest większa niż page_size, zwracany jest next_page_token, który można przekazać do page_token, aby uzyskać następną stronę wyników w kolejnych żądaniach. 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 zwracają błąd INVALID_ARGUMENT.

Jeśli podano 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 metody TextSearch. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie parametry inne niż page_token, page_size i max_result_count przekazane do TextSearch muszą być zgodne z pierwotnym wywołaniem, które przekazało token strony. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.
price_levels[]

PriceLevel

Służy do zawężenia wyszukiwania do miejsc oznaczonych jako określone poziomy cen. Użytkownicy mogą wybrać dowolne kombinacje poziomów cen. Domyślnie zaznaczono wszystkie poziomy cen.
strict_type_filtering

bool

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

LocationBias

Region wyszukiwania. Ta lokalizacja służy jako preferencja, co oznacza, że mogą zostać zwrócone wyniki z okolic tej lokalizacji. Nie można go ustawić razem z parametrem location_restriction.
location_restriction

LocationRestriction

Region wyszukiwania. Ta lokalizacja służy jako ograniczenie, co oznacza, że wyniki spoza danej lokalizacji nie zostaną zwrócone. Nie można go ustawić razem z parametrem location_bias.
ev_options

EVOptions

Opcjonalnie: Ustaw opcje wyszukiwania EV w prośbie o wyszukiwanie miejsca.
routing_parameters

RoutingParameters

Opcjonalnie: dodatkowe parametry do kierowania na wyniki;
search_along_route_parameters

SearchAlongRouteParameters

Opcjonalnie: dodatkowe parametry proto do wyszukiwania na trasie;
include_pure_service_area_businesses

bool

Opcjonalnie: Uwzględnij firmy działające tylko na określonym obszarze, jeśli pole zawiera wartość true. Firma działająca 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. Firmy te nie mają adresu fizycznego ani lokalizacji w Mapach Google. W przypadku tych firm Places nie zwróci pól location, plus_code ani innych pól związanych z lokalizacją.

EVOptions

Opcje wyszukiwania EV w prośbie o wyszukiwanie miejsc.

Pola
minimum_charging_rate_kw

double

Opcjonalnie: Minimalna wymagana szybkość ładowania w kilowatach. Miejsce z niższą stawką niż określona zostaje odfiltrowane.
connector_types[]

EVConnectorType

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

LocationBias

Region wyszukiwania. Ta lokalizacja służy jako preferencja, co oznacza, że mogą zostać zwrócone wyniki z okolic tej lokalizacji.

Pola

Pole unii type.

type może być tylko jednym z tych elementów:
rectangle

Viewport

Prostokąt określony przez narożniki północno-wschodni i południowo-zachodni. rectangle.high() musi być punktem północno-wschodnim prostokątnego obszaru widoku. rectangle.low() musi być punktem południowo-zachodnim prostokątnego obszaru widoku. Wartość rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to pusty zakres szerokości geograficznej. Widok prostokątny nie może być szerszy niż 180 stopni.
circle

Circle

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

LocationRestriction

Region wyszukiwania. Ta lokalizacja służy jako ograniczenie, co oznacza, że wyniki spoza danej lokalizacji nie zostaną zwrócone.

Pola

Pole unii type.

type może być tylko jednym z tych elementów:
rectangle

Viewport

Prostokąt określony przez narożniki północno-wschodni i południowo-zachodni. rectangle.high() musi być punktem północno-wschodnim prostokątnego obszaru widoku. rectangle.low() musi być punktem południowo-zachodnim prostokątnego obszaru widoku. Wartość rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to pusty zakres szerokości geograficznej. Widok prostokątny nie może być szerszy niż 180 stopni.

RankPreference

sposób porządkowania wyników w odpowiedzi.

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED W przypadku zapytania dotyczącego kategorii, np. „Restauracje w Nowym Jorku”, domyślnie jest używana trafność. W przypadku zapytań niebędących zapytaniami o kategorię, np. „Warszawa, Polska”, zalecamy pozostawienie opcji rankPreference puste.
DISTANCE Ustawia wyniki według odległości.
RELEVANCE Uporządkowuje wyniki według trafności. kolejność sortowania określona na podstawie normalnego zbioru rankingów;

SearchAlongRouteParameters

Określa wstępnie obliczony poligon z interfejsu Routes API, który definiuje trasę do wyszukania. Wyszukiwanie wzdłuż trasy jest podobne do korzystania z opcji locationBias lub locationRestriction, aby wpływać na wyniki wyszukiwania. Opcje locationBias i locationRestriction umożliwiają określenie regionu, w którym mają być wyświetlane wyniki wyszukiwania, ale ta opcja pozwala na wyświetlanie wyników na trasie podróży.

Wyniki nie muszą być zlokalizowane wzdłuż podanej trasy, ale są sortowane w obszarze wyszukiwania zdefiniowanym przez polilinię i opcjonalnie przez locationBias lub locationRestriction na podstawie minimalnego czasu objazdu od punktu początkowego do docelowego. Wyniki mogą być podane dla trasy alternatywnej, zwłaszcza jeśli podana linia wielokąta nie określa optymalnej trasy od punktu początkowego do docelowego.

Pola
polyline

Polyline

Wymagany. Linia łamana trasy.

SearchTextResponse

Protokół odpowiedzi dla SearchText.

Pola
places[]

Place

Lista miejsc, które spełniają kryteria wyszukiwania tekstowego użytkownika.
routing_summaries[]

RoutingSummary

Lista podsumowań tras, w której każdy wpis jest powiązany z odpowiednim miejscem w tym samym indeksie w polu places. Jeśli podsumowanie trasy jest niedostępne dla jednego z miejsc, będzie zawierać pusty wpis. Ta lista będzie zawierać tyle pozycji, ile jest w liście miejsc (jeśli jest wymagana).
contextual_contents[]

ContextualContent

Funkcja 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 prośbie. Jeśli treści kontekstowe nie są dostępne w przypadku jednego z miejsc, zwrócą treści niekontekstualne. Będzie pusty tylko wtedy, gdy treści nie są dostępne dla tego miejsca. Ta lista będzie zawierać tyle pozycji, ile jest w liście miejsc (jeśli jest wymagana).
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 za pomocą tego samego zapytania tekstowego, które zostało określone w żądaniu w Mapach Google.

TravelMode

Opcje trybu podróży. Te opcje odpowiadają funkcjom interfejsu Routes API.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie wybrano środka transportu. Domyślna wartość to DRIVE.
DRIVE podróż samochodem osobowym,
BICYCLE podróżować rowerem, Nieobsługiwane w przypadku search_along_route_parameters.
WALK Chodzenie. Nieobsługiwane w przypadku search_along_route_parameters.
TWO_WHEELER Motorowery i motocykle. Pamiętaj, że jest to odrębne pojęcie od BICYCLE, które obejmuje transport ręczny. Nieobsługiwane w przypadku search_along_route_parameters. Obsługiwane tylko w krajach wymienionych na stronie Kraje i regiony obsługiwane w przypadku pojazdów dwukołowych.