Package google.maps.places.v1

Indeks

Miejsca

Definicja usługi dla interfejsu Places API. Uwaga: każde żądanie (oprócz żądań autouzupełniania) wymaga maski pola ustawionej poza protokołem żądania (nie zakłada się all/*). 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.
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Pobierz plik multimedialny ze zdjęciem z ciągiem referencyjnym zdjęcia.
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

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

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Wyszukiwanie miejsc w pobliżu lokalizacji.
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Wyszukiwanie miejsc na podstawie zapytania tekstowego.

AuthorAttribution

Informacje o autorze danych użytkowników. Używany w Photo i Review.

Pola
display_name

string

Imię i nazwisko autora tekstu Photo lub Review.
uri

string

Identyfikator URI autora elementu Photo lub Review.
photo_uri

string

Identyfikator URI zdjęcia profilowego autora elementu Photo lub Review.

AutocompletePlacesRequest

Żądanie proto dla AutocompletePlaces.

Pola
input

string

Wymagane. Ciąg tekstowy służący do wyszukiwania.
location_bias

LocationBias

Opcjonalnie. Odchylenia wyników 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ą promowane ze względu na adres IP, co oznacza, że adres ten zostanie zmapowany na nieprecyzyjną lokalizację i wykorzystany jako sygnał odchylenia.
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ą promowane ze względu na adres IP, co oznacza, że adres ten zostanie zmapowany na nieprecyzyjną lokalizację i wykorzystany jako sygnał odchylenia.
included_primary_types[]

string

Opcjonalnie. Uwzględniono typ głównego miejsca (np. „restauracja” lub „stacja benzynowa”) ze strony https://developers.google.com/maps/documentation/places/web-service/place-types. Miejsce jest zwracane tylko wtedy, gdy na liście znajduje się jego główny typ. Można określić maksymalnie 5 wartości. Jeśli nie podasz żadnych typów miejsc, zwracane są wszystkie typy miejsc.
included_region_codes[]

string

Opcjonalnie. Uwzględnij wyniki tylko z określonych regionów określonych jako maksymalnie 15 2-znakowych kodów regionów CLDR. Pusty zestaw nie ogranicza wyników. Jeśli ustawisz zarówno wartość location_restriction, jak i included_region_codes, wyniki będą znajdować się w obszarze skrzyżowania.
language_code

string

Opcjonalnie. Język, w którym mają być zwracane wyniki. Wartość domyślna to en-US. Wyniki mogą być w różnych językach, jeśli język używany w input jest inny niż 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 i ranking wyników oraz może wpływać na zwracane wyniki. Nie ogranicza to wyników do określonego regionu. Aby ograniczyć wyniki do regionu, użyj operatora region_code_restriction.
origin

LatLng

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

int32

Opcjonalnie. Przesunięcie znaków w standardzie Unicode liczone od zera za pomocą input wskazującą pozycję kursora w pliku input. Położenie kursora może mieć wpływ na zwracane prognozy.

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

bool

Opcjonalnie. Jeśli ma wartość true (prawda), odpowiedź będzie zawierać zarówno podpowiedzi dotyczące miejsca, jak i zapytania. W przeciwnym razie odpowiedź będzie zwracać tylko podpowiedzi dotyczące miejsc.
session_token

string

Opcjonalnie. Ciąg znaków, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny adres URL i bezpieczny dla nazwy pliku ciąg base64 o długości nie większej niż 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja zaczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy się, gdy wybiera miejsce i wysyła żądanie informacji o miejscu lub weryfikacji adresu. Każda sesja może obejmować wiele zapytań, po których następuje 1 prośba o informacje o miejscu lub o weryfikację adresu. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr session_token zostanie pominięty lub ponownie użyjesz tokena sesji, opłata za sesję zostanie naliczona tak, jakby nie podano żadnego tokena sesji (każde żądanie jest rozliczane oddzielnie).

Zalecamy stosowanie tych wytycznych:

  • Używaj tokenów sesji dla wszystkich wywołań autouzupełniania miejsc.
  • Generuj nowy token dla każdej sesji. Zalecamy użycie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane we wszystkich żądaniach autouzupełniania miejsc, informacji o miejscu i weryfikacji adresu w ramach sesji należą do tego samego projektu Cloud Console.
  • Pamiętaj, aby przekazywać unikalny token sesji dla każdej nowej sesji. Używanie tego samego tokena w więcej niż 1 sesji spowoduje, że każde żądanie zostanie rozliczone indywidualnie.

LocationBias

Region do przeszukania. Wyniki mogą być stronnicze.

Pola

Pole sumy type.

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

Viewport

Widoczny obszar wyznaczony przez róg północno-wschodni.
circle

Circle

Okrąg określony przez punkt środkowy i promień.

LocationRestriction

Region do przeszukania. Wyniki będą ograniczone do określonego regionu.

Pola

Pole sumy type.

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

Viewport

Widoczny obszar wyznaczony przez róg północno-wschodni.
circle

Circle

Okrąg określony przez punkt środkowy i promień.

AutocompletePlacesResponse

Protokół odpowiedzi dla AutocompletePlaces.

Pola
suggestions[]

Suggestion

Zawiera listę sugestii uporządkowanych malejąco według trafności.

Sugestia

Wynik sugestii autouzupełniania.

Pola

Pole sumy kind.

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

PlacePrediction

Prognoza dotycząca miejsca.
query_prediction

QueryPrediction

Prognoza dla zapytania.

FormattableText

Tekst reprezentujący podpowiedź dotyczącą miejsca lub zapytania. Tekst może być używany w niezmienionej postaci lub w sposób sformatowany.

Pola
text

string

Tekst, który może być użyty w niezmienionej formie lub za pomocą funkcji matches.
matches[]

StringRange

Lista zakresów ciągów znaków wskazujących miejsce dopasowania żądania wejściowego w funkcji text. Możesz użyć zakresów do formatowania określonych części funkcji text. Podłańcuchy mogą nie być dokładnymi dopasowaniami do input, jeśli zostało ono określone na podstawie innych kryteriów (np. korekty pisowni lub transliteracji).

Te wartości to przesunięcia znaków Unicode text. Zakresy są gwarantowane uporządkowane w rosnących wartościach przesunięcia.

PlacePrediction

Wyniki prognozy dla podpowiedzi autouzupełniania miejsc.

Pola
place

string

Nazwa zasobu sugerowanego miejsca. Ta nazwa może być używana w innych interfejsach API, które akceptują nazwy miejsc.
place_id

string

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

FormattableText

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

Parametr 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 ze sobą elementy interfejsu, mogą zamiast tego użyć elementu structured_format. Są to 2 różne sposoby przedstawiania prognozy dotyczącej miejsca. Użytkownicy nie powinni analizować działania structured_format na text i na odwrót.

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

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

StructuredFormat

Podział prognozy miejsca na tekst główny zawierający nazwę miejsca i tekst dodatkowy zawierający dodatkowe cechy ujednoznaczniejące, np. nazwę miasta lub regionu.

Parametr structured_format jest zalecany dla programistów, którzy chcą wyświetlać 2 oddzielne, ale powiązane elementy interfejsu. Deweloperzy, którzy chcą wyświetlać pojedynczy element interfejsu, mogą zamiast tego użyć elementu text. Są to 2 różne sposoby przedstawiania prognozy dotyczącej miejsca. Użytkownicy nie powinni analizować działania structured_format na text i na odwrót.
types[]

string

Lista typów dotyczących tego miejsca z Tabeli A lub B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

Typ to kategoria miejsca. Miejsca o wspólnych typach mają podobne cechy.
distance_meters

int32

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

QueryPrediction

Wyniki prognozy dla prognozy autouzupełniania zapytania.

Pola
text

FormattableText

Przewidywany tekst. Ten tekst nie reprezentuje miejsca, lecz zapytaniem, którego można użyć w punkcie końcowym wyszukiwania (np. wyszukiwanie tekstowe).

Parametr 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 ze sobą elementy interfejsu, mogą zamiast tego użyć elementu structured_format. Są to 2 różne sposoby reprezentowania prognozy zapytania. Użytkownicy nie powinni analizować działania structured_format na text i na odwrót.

Może występować w różnych językach, jeśli żądania 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 z dodatkowymi cechami ujednoznaczniejącymi (np. nazwą miasta lub regionu).

Parametr structured_format jest zalecany dla programistów, którzy chcą wyświetlać 2 oddzielne, ale powiązane elementy interfejsu. Deweloperzy, którzy chcą wyświetlać pojedynczy element interfejsu, mogą zamiast tego użyć elementu text. Są to 2 różne sposoby reprezentowania prognozy zapytania. Użytkownicy nie powinni analizować działania structured_format na text i na odwrót.

StringRange

Identyfikuje podłańcuch w podanym tekście.

Pola
start_offset

int32

Przesunięcie od zera pierwszego znaku Unicode ciągu znaków (włącznie).
end_offset

int32

Przesunięcie od zera ostatniego znaku Unicode (wyłącznie).

StructuredFormat

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

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

Tekst dodatkowy zawiera dodatkowe elementy ujednoznaczniejące (np. nazwę miasta lub regionu), które umożliwiają dalszą identyfikację miejsca lub doprecyzowanie zapytania.

Pola
main_text

FormattableText

Reprezentuje nazwę miejsca lub zapytania.
secondary_text

FormattableText

Przedstawia dodatkowe jednoznaczne obiekty (takie jak miasto lub region) w celu dalszej identyfikacji miejsca lub doprecyzowania zapytania.

Koło

Koło z osią czasu ustawioną jako środek i promieniem.

Pola
center

LatLng

Wymagane. Długość i szerokość geograficzna pośrodku.

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

double

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

ContentBlock

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

Pola
topic

string

Temat treści, na przykład „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.

Pliki referencyjne 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ść związana z zapytaniem dotyczącym miejsca.

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, kontekstowe w odniesieniu do zapytania.
justifications[]

Justification

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

uzasadnienia dotyczące miejsca,

Uzasadnienie

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

uzasadnienia dotyczące miejsca, Uzasadnienie odpowiada na pytanie, dlaczego dane miejsce może zainteresować użytkownika.

Pola

Pole sumy justification.

justification może być tylko jedną z tych wartości:
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 on atrybuty firmy, które mogą zainteresować użytkowników.

Pola
takeout

bool

jeśli miejsce oferuje dania na wynos.
delivery

bool

Jeśli miejsce oferuje dostawę.
dine_in

bool

Jeśli w hotelu można zjeść na miejscu

ReviewJustification

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

Uzasadnienia opinii użytkownika. Wyróżnia to sekcję opinii użytkownika, która może być dla niego interesująca. Jeśli na przykład zapytanie to „pizza z drewna”, w uzasadnieniu sprawdzenia zostanie wyróżniony tekst odpowiadający wyszukiwanemu hasłu.

Pola
highlighted_text

HighlightedText
review

Review

Recenzja, na podstawie której został wygenerowany zaznaczony tekst.

HighlightedText

Tekst wyróżniony przez uzasadnienie. Jest to podzbiór samej opinii. Dokładne słowo, które ma być zaznaczone, jest oznaczone za pomocą elementu SelectionedTextRange. W tekście może być 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 znajdującej się w Place. Terminology znajduje się na stronie https://afdc.energy.gov/fuels/electricity_infrastructure.html. Do ładowania samochodów wystarczy 1 port. Jeden port ma co najmniej jedno złącze. Jedna stacja ma co najmniej 1 port.

Pola
connector_count

int32

Liczba złączy na tej stacji. Niektóre porty mogą jednak mieć wiele złączy, ale w danym momencie mogą ładować tylko 1 samochód (np. liczba złączy może być większa od łącznej liczby samochodów, które mogą jednocześnie ładować ładowanie).
connector_aggregation[]

ConnectorAggregation

Lista zbiorów złączy ładowania pojazdów elektrycznych, które zawierają złącza tego samego typu i z tą samą szybkością ładowania.

ConnectorAggregation

Informacje o ładowaniem pojazdów elektrycznych pogrupowane według typu [type, max_charge_rate_kw]. Pokazuje agregację ładowania pojazdów elektrycznych w przypadku złączy o tym samym typie i maksymalnej szybkości ładowania w kW.

Pola
type

EVConnectorType

Typ oprogramowania sprzęgającego tej agregacji.
max_charge_rate_kw

double

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

int32

Liczba złączy w tej agregacji.
availability_last_update_time

Timestamp

Sygnatura czasowa ostatniej aktualizacji informacji o dostępności oprogramowania sprzęgającego w tej agregacji.
available_count

int32

Liczba aktualnie dostępnych wtyczek w tej agregacji.
out_of_service_count

int32

Liczba oprogramowań sprzęgających w tej agregacji, które są obecnie niedostępne.

EVConnectorType

Dodatkowe informacje i kontekst na temat typów złączy ł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 oprogramowania sprzęgającego.
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 Oprogramowanie sprzęgające typu CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Mieszany system ładowania (AC i DC). Na podstawie SAE. złącze typu J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Mieszany system ładowania (AC i DC). Na podstawie łącznika Mennekes typu 2
EV_CONNECTOR_TYPE_TESLA Standardowe oprogramowanie sprzęgające TESLA. To NACS w Ameryce Północnej, ale może być inny niż NACS w innych częściach świata (np. CCS Combo 2 (CCS2) lub GB/T). Ta wartość jest mniej reprezentatywna dla rzeczywistego typu złącza, ponieważ więcej oznacza możliwość ładowania pojazdu marki Tesla na stacji ładowania należącej do Tesli.
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.

FuelOptions

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

Pola
fuel_prices[]

FuelPrice

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

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.
REGULAR_UNLEADED Zwykła bez lidera.
MIDGRADE Średnio zaawansowana.
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 To miejsce oferuje paliwo LPG.
E80 E 80.
E85 E 85.
METHANE Metan.
BIO_DIESEL Bioolej napędowy.
TRUCK_DIESEL Olej napędowy do ciężarówki.

GetPhotoMediaRequest

Prośba o pobranie zdjęcia miejsca przy użyciu nazwy zasobu zdjęcia.

Pola
name

string

Wymagane. Nazwa zasobu nośnika ze zdjęciem w formacie: places/{place_id}/photos/{photo_reference}/media.

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

int32

Opcjonalnie. Określa maksymalną żądaną szerokość obrazu w pikselach. Jeśli obraz jest mniejszy niż określone wartości, zostanie zwrócony obraz oryginalny. Jeśli obraz będzie większy w każdym z wymiarów, zostanie przeskalowany tak, by pasował do mniejszego z nich (ograniczony do 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.

Należy określić co najmniej jedną wartość max_height_px lub max_width_px. Jeśli nie określono wartości max_height_px ani max_width_px, zwracany jest błąd INVALID_ARGUMENT.
max_height_px

int32

Opcjonalnie. Określa maksymalną pożądaną wysokość obrazu w pikselach. Jeśli obraz jest mniejszy niż określone wartości, zostanie zwrócony obraz oryginalny. Jeśli obraz będzie większy w każdym z wymiarów, zostanie przeskalowany tak, by pasował do mniejszego z nich (ograniczony do 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.

Należy określić co najmniej jedną wartość max_height_px lub max_width_px. Jeśli nie określono wartości max_height_px ani max_width_px, zwracany jest błąd INVALID_ARGUMENT.
skip_http_redirect

bool

Opcjonalnie. Jeśli jest ustawione, pomiń domyślne działanie przekierowania HTTP i wyrenderuj odpowiedź w formacie tekstowym (na przykład w formacie JSON w przypadku użycia HTTP). Jeśli zasada jest nieskonfigurowana, następuje przekierowanie HTTP, które przekierowuje wywołanie do nośnika graficznego. Ta opcja jest ignorowana w przypadku żądań innych niż HTTP.

GetPlaceRequest

Żądanie pobrania 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 dostępny).

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

string

Opcjonalnie. Kod Unicode kraju/regionu (CLDR) lokalizacji, z której pochodzi żądanie. Służy on do wyświetlania szczegółowych informacji o miejscu, takich jak nazwa miejsca z danego regionu, jeśli jest dostępna. Parametr może wpływać na wyniki w zależności od obowiązującego prawa. 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 znaków, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny adres URL i bezpieczny dla nazwy pliku ciąg base64 o długości nie większej niż 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja zaczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy się, gdy wybiera miejsce i wysyła żądanie informacji o miejscu lub weryfikacji adresu. Każda sesja może obejmować wiele zapytań, po których następuje 1 prośba o informacje o miejscu lub o weryfikację adresu. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr session_token zostanie pominięty lub ponownie użyjesz tokena sesji, opłata za sesję zostanie naliczona tak, jakby nie podano żadnego tokena sesji (każde żądanie jest rozliczane oddzielnie).

Zalecamy stosowanie tych wytycznych:

  • Używaj tokenów sesji dla wszystkich wywołań autouzupełniania miejsc.
  • Generuj nowy token dla każdej sesji. Zalecamy użycie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane we wszystkich żądaniach autouzupełniania miejsc, informacji o miejscu i weryfikacji adresu w ramach sesji należą do tego samego projektu Cloud Console.
  • Pamiętaj, aby przekazywać unikalny token sesji dla każdej nowej sesji. Używanie tego samego tokena w więcej niż 1 sesji spowoduje, że każde żądanie zostanie rozliczone indywidualnie.

Zdjęcie

Informacje o zdjęciu danego miejsca.

Pola
name

string

Identyfikator. Dokument referencyjny reprezentujący zdjęcie tego miejsca, który może posłużyć do ponownego wyszukania zdjęcia miejsca (nazywany też nazwą „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.

PhotoMedia

Zdjęcia z interfejsu Places API.

Pola
name

string

Nazwa zasobu nośnika ze zdjęciem w formacie: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

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

Miejsce

Wszystkie informacje dotyczące miejsca.

Pola
name

string

Nazwa zasobu tego miejsca w formacie places/{place_id}. Może służyć do wyszukiwania miejsca.
id

string

Niepowtarzalny identyfikator miejsca.
display_name

LocalizedText

Lokalna nazwa miejsca, odpowiednia jako krótki opis zrozumiały dla człowieka. Na przykład „Google Sydney”, „Starbucks”, „Pyrmont” itp.
types[]

string

Zestaw tagów typów dla tego wyniku. Na przykład „polityczne” i „miejscowość”. 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.
primary_type

string

Podstawowy typ danego wyniku. Ten typ musi być jednym z typów interfejsu Places API. Na przykład „restauracja”, „kawiarnia”, „lotnisko” itp. Miejsce może mieć tylko jeden typ główny. 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.
primary_type_display_name

LocalizedText

Wyświetlana nazwa typu głównego zlokalizowana na język żądania, jeśli ma to zastosowanie. 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.
national_phone_number

string

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

string

Zrozumiały dla człowieka numer telefonu do danego miejsca w formacie międzynarodowym.
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.
address_components[]

AddressComponent

Powtórzone komponenty dla każdego poziomu miejscowości. Zwróć uwagę na następujące fakty dotyczące tablicy address_components[]: – tablica komponentów adresu może zawierać więcej komponentów niż adres sformatowany_adres. – tablica nie musi zawierać wszystkich jednostek politycznych zawierających adres oprócz tych uwzględnionych w sformatowanym_adresie. Aby pobrać wszystkie jednostki polityczne z określonym adresem, należy użyć odwrotnego geokodowania, przesyłając szerokość i długość geograficzną adresu jako parametr w żądaniu. – Nie ma gwarancji, że format odpowiedzi pozostanie taki sam między żądaniami. W szczególności liczba elementów address_components różni się w zależności od żądanego adresu i może się z czasem zmieniać dla tego samego adresu. Komponent może zmieniać pozycję w tablicy. Typ komponentu może się zmieniać. Konkretnego komponentu może brakować w późniejszej odpowiedzi.
plus_code

PlusCode

Plus Code lokalizacji miejsca (szerokość i długość geograficzna).
location

LatLng

Pozycja tego miejsca.
viewport

Viewport

Widoczny obszar umożliwiający wyświetlanie miejsca na mapie średniej wielkości.
rating

double

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

string

Adres URL prowadzący do dodatkowych informacji o tym miejscu.
website_uri

string

Wiarygodna witryna dotycząca tego miejsca, np. strona główna firmy. Uwaga: w przypadku miejsc będących częścią sieci (np. sklepu IKEA) będzie to zazwyczaj witryna danego sklepu, a nie całej sieci.
reviews[]

Review

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

OpeningHours

W standardowych godzinach pracy.
photos[]

Photo

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

string

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

BusinessStatus

Stan firmy dla danego miejsca.
price_level

PriceLevel

Poziom ceny miejsca.
attributions[]

Attribution

Zbiór dostawców danych, który musi być wyświetlany z tym wynikiem.
icon_mask_base_uri

string

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

string

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

OpeningHours

Godziny pracy w ciągu najbliższych 7 dni (w tym dzisiaj). Ten okres rozpoczyna się o północy w dniu przesłania żądania i kończy o 23:59 po sześciu dniach. To pole zawiera pole podrzędne z informacjami specjalnymi o wszystkich godzinach, które jest ustawione dla dat o wyjątkowych godzinach.
current_secondary_opening_hours[]

OpeningHours

Zawiera szereg wpisów na następne siedem dni, w tym informacje o dodatkowych godzinach pracy firmy. Dodatkowe godziny pracy różnią się od głównych godzin otwarcia firmy. Na przykład w restauracji restauracji można podać godziny otwarcia samochodu lub dostawy jako dodatkowe godziny. To pole wypełnia pole podrzędne typu, które jest pobierane ze wstępnie zdefiniowanej listy typów godzin otwarcia (np. Drive_THROUGH, PICKUP lub TakeOUT) na podstawie rodzajów miejsca. To pole zawiera pole podrzędne z informacjami specjalnymi o wszystkich godzinach, które jest ustawione dla dat o wyjątkowych godzinach.
regular_secondary_opening_hours[]

OpeningHours

Zawiera tablicę wpisów z informacjami o zwykłych godzinach pracy firmy. Dodatkowe godziny pracy różnią się od głównych godzin otwarcia firmy. Na przykład w restauracji restauracji można podać godziny otwarcia samochodu lub dostawy jako dodatkowe godziny. To pole wypełnia pole podrzędne typu, które jest pobierane ze wstępnie zdefiniowanej listy typów godzin otwarcia (np. Drive_THROUGH, PICKUP lub TakeOUT) na podstawie rodzajów miejsca.
editorial_summary

LocalizedText

Zawiera podsumowanie miejsca. Podsumowanie składa się z omówienia tekstowego i w stosownych przypadkach zawiera również kod języka. Tekst podsumowania musi zostać przedstawiony w niezmienionej formie i nie może być modyfikowany.
payment_options

PaymentOptions

Opcje płatności akceptowane w tym miejscu. Jeśli dane dotyczące opcji płatności są niedostępne, pole opcji płatności nie jest aktywne.
parking_options

ParkingOptions

Dostępne opcje parkowania.
sub_destinations[]

SubDestination

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

FuelOptions

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

EVChargeOptions

Informacje o opcjach ładowania EV.
generative_summary

GenerativeSummary

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

Wygenerowane przez AI podsumowanie miejsca.
area_summary

AreaSummary

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

Wygenerowane przez AI podsumowanie obszaru, na którym znajduje się dane miejsce.
utc_offset_minutes

int32

Liczba minut przesunięcia strefy czasowej w tym miejscu względem czasu UTC. Wartość ta jest wyrażona w minutach w celu obsługi stref czasowych przesuniętych o ułamki godziny, np.X godz. i 15 minut.
user_rating_count

int32

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

bool

Określa, czy firma obsługuje dania na wynos.
delivery

bool

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

bool

Określa, czy firma oferuje stoliki 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 tym miejscu serwowane jest śniadanie.
serves_lunch

bool

Określa, czy w miejscu serwowane są lunche.
serves_dinner

bool

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

bool

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

bool

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

bool

Określa, czy w miejscu serwowane są brunche.
serves_vegetarian_food

bool

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

bool

Goście mają do dyspozycji stoliki na świeżym powietrzu.
live_music

bool

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

bool

Na miejscu dostępne jest menu dla dzieci.
serves_cocktails

bool

Bar serwujący koktajle.
serves_dessert

bool

Lokal serwuje desery.
serves_coffee

bool

Lokal serwuje kawę.
good_for_children

bool

Miejsce odpowiednie dla dzieci.
allows_dogs

bool

W tym miejscu można przebywać z psami.
restroom

bool

Na miejscu jest toaleta.
good_for_groups

bool

Miejsce jest przeznaczone dla grup.
good_for_watching_sports

bool

Miejsce jest odpowiednie do oglądania transmisji sportowych.
accessibility_options

AccessibilityOptions

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

AccessibilityOptions

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

Pola
wheelchair_accessible_parking

bool

Na terenie obiektu znajduje się parking dla osób na wózkach.
wheelchair_accessible_entrance

bool

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

bool

Na miejscu jest toaleta z dostępem dla osób na wózkach.
wheelchair_accessible_seating

bool

Na miejscu znajduje się miejsce na wózek inwalidzki.

AddressComponent

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

Pola
long_text

string

Pełny opis tekstowy lub nazwa komponentu adresu. Na przykład składnik adresu dla kraju Australia może mieć nazwę „long_name” w formacie „Australia”.
short_text

string

Skrócona nazwa tekstowa komponentu adresu (jeśli jest dostępna). Na przykład składnik adresu dla kraju Australii może mieć krótką nazwę „AU”.
types[]

string

Tablica wskazująca typy komponentu adresu.
language_code

string

Język użyty 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.

Wygenerowane przez AI podsumowanie obszaru, na którym znajduje się dane miejsce.

Pola
content_blocks[]

ContentBlock

Bloki treści tworzące podsumowanie obszaru. Każda bryła ma osobny temat dotyczący danego obszaru.

Atrybucja

Informacje o dostawcach danych dotyczących tego miejsca.

Pola
provider

string

Nazwa dostawcy danych o miejscu.
provider_uri

string

Identyfikator URI dostawcy danych miejsca.

BusinessStatus

Status firmy dla miejsca.

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

GenerativeSummary

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

Wygenerowane przez AI podsumowanie miejsca.

Pola
overview

LocalizedText

Omówienie miejsca.
description

LocalizedText

Szczegółowy opis miejsca.
references

References

Pliki referencyjne, które służą do generowania opisu podsumowującego.

OpeningHours

Informacje o godzinach pracy danego miejsca.

Pola
periods[]

Period

W dni powszednie to miejsce jest otwarte. Okresy są ułożone chronologicznie, zaczynając od niedzieli w lokalnej strefie czasowej. Pusta wartość (ale jej brak) oznacza miejsce, które nigdy nie jest otwarte, np. dlatego, że jest tymczasowo zamknięte na czas remontu.
weekday_descriptions[]

string

Zlokalizowane ciągi znaków opisujące godziny otwarcia tego miejsca, jeden ciąg na każdy dzień tygodnia. To pole jest puste, jeśli godziny są nieznane lub nie można ich przekonwertować na zlokalizowany tekst. Przykład: „Niedz.: 18:00–06:00”
secondary_hours_type

SecondaryHoursType

Ciąg typu określający typ dodatkowych godzin pracy.
special_days[]

SpecialDay

Uporządkowane informacje na specjalne dni w okresie, który obejmują zwrócone godziny otwarcia. Dni specjalne to dni, które mogą wpływać na godziny otwarcia danego miejsca, np. Boże Narodzenie. Ustaw wartości current_opening_hours i current_secondary_opening_hours, jeśli są one wyjątkowe.
open_now

bool

Czy to miejsce jest teraz otwarte? Zawsze obecna, chyba że brakuje nam danych o porze dnia lub strefie czasowej w przypadku tych godzin otwarcia.

Okres

Przez okres, w którym miejsce pozostaje w stanie open_now.

Pola
open

Point

Godzina, o której miejsce zaczyna być otwarte.
close

Point

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

Punkt

Punkty dotyczące zmiany stanu.

Pola
date

Date

Data w lokalnej strefie czasowej danego miejsca.
truncated

bool

Wskazuje, czy ten punkt końcowy został obcięty. Obcinanie ma miejsce, gdy rzeczywiste godziny nie mieszczą się w godzinach, w których chcemy cofnąć czas, dlatego skracamy je do tych granic. Dzięki temu zwracane są maksymalnie 24 x 7 godzin, licząc od północy w dniu otrzymania żądania.
day

int32

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

int32

Godzina z 2 cyframi. Ma zakres od 00 do 23.
minute

int32

Minuta z 2 cyframi. Ma zakres od 00 do 59.

SecondaryHoursType

Typ dodatkowych godzin pracy.

Wartości w polu enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Wartość domyślna, gdy typ godziny dodatkowej nie jest określony.
DRIVE_THROUGH Godziny otwarcia sklepu, restauracji lub aptek.
HAPPY_HOUR happy hours.
DELIVERY Godzina dostawy.
TAKEOUT Godzina z jedzeniem na wynos
KITCHEN Godzina w kuchni.
BREAKFAST Godzina śniadania.
LUNCH Pora lunchu.
DINNER Godzina kolacji.
BRUNCH Godzina późnego śniadania.
PICKUP Godzina odbioru.
ACCESS Godziny dostępu do miejsc przechowywania danych.
SENIOR_HOURS Niestandardowe godziny otwarcia dla seniorów.
ONLINE_SERVICE_HOURS Godziny pracy online.

SpecialDay

Uporządkowane informacje na specjalne dni w okresie, który obejmują zwrócone godziny otwarcia. Dni specjalne to dni, które mogą wpływać 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. Na parkingu może być jednocześnie kilka miejsc parkingowych.

Pola
free_parking_lot

bool

Parking jest wliczony w cenę.
paid_parking_lot

bool

W ofercie są płatne parkingi.
free_street_parking

bool

Parking przy ulicy jest wliczony w cenę.
paid_street_parking

bool

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

bool

Na terenie obiektu znajduje się parking z obsługą.
free_garage_parking

bool

Parking w garażu jest wliczony w cenę.
paid_garage_parking

bool

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

PaymentOptions

Opcje płatności akceptowane w tym miejscu.

Pola
accepts_credit_cards

bool

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

bool

Miejsce akceptuje płatności kartą debetową.
accepts_cash_only

bool

Miejsce akceptuje wyłącznie gotówkę. W miejscach z tym atrybutem nadal mogą być akceptowane inne formy płatności.
accepts_nfc

bool

Place akceptuje płatności NFC.

PlusCode

Plus Code (http://plus.codes) to odniesienie do lokalizacji w dwóch formatach: globalny kod definiujący wymiary 14 m x 14 m (1/8000 stopnia) lub mniejszy prostokąt oraz kod złożony, zastępując prefiks adresem referencyjnym.

Pola
global_code

string

Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, który reprezentuje obszar o wymiarach 1/8000 x 1/8000 stopnia (ok. 14 x 14 metrów).
compound_code

string

Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, który zawiera sufiks kodu globalnego i zastępuje prefiks sformatowaną nazwą jednostki referencyjnej.

SubDestination

Umieść nazwę zasobu i identyfikatory podrzędnych miejsc docelowych, które odnoszą się do danego miejsca. Na przykład różne terminale to różne miejsca docelowe lotniska.

Pola
name

string

Nazwa zasobu podrzędnego miejsca docelowego.
id

string

Identyfikator miejsca docelowego.

PriceLevel

Poziom ceny miejsca.

Wartości w polu enum
PRICE_LEVEL_UNSPECIFIED Poziom cen miejsca jest nieokreślony lub nieznany.
PRICE_LEVEL_FREE Usługi są bezpłatne.
PRICE_LEVEL_INEXPENSIVE Plac oferuje usługi w przystępnych cenach.
PRICE_LEVEL_MODERATE Plac oferuje usługi w umiarkowanej cenie.
PRICE_LEVEL_EXPENSIVE Plac oferuje drogie usługi.
PRICE_LEVEL_VERY_EXPENSIVE Plac oferuje bardzo drogie usługi.

Źródła

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

Odwołanie, z którym związane są treści generatywne.

Pola
reviews[]

Review

Opinie, które służą jako odniesienia.
places[]

string

Lista nazw zasobów wymienionych miejsc. Ta nazwa może być używana w innych interfejsach API, które akceptują nazwy zasobów Miejsc.

Sprawdź

Informacje o opinii o danym miejscu.

Pola
name

string

Dokument referencyjny reprezentujący opinię o tym miejscu, który może zostać użyty do ponownego wyszukiwania opinii o tym miejscu (nazywany też nazwą „zasobu” interfejsu API: places/{place_id}/reviews/{review}).
relative_publish_time_description

string

Ciąg sformatowany ostatnio czas, w którym podano czas sprawdzania w stosunku do bieżącego czasu, w formie odpowiedniej dla danego języka i kraju.
text

LocalizedText

Zlokalizowany tekst opinii.
original_text

LocalizedText

Tekst opinii w oryginalnym języku.
rating

double

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

AuthorAttribution

Autor tej opinii.
publish_time

Timestamp

Sygnatura czasowa sprawdzenia.

SearchNearbyRequest

Poproś o proto na potrzeby 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 jest nieokreślony lub nierozpoznany, mogą zostać zwrócone szczegóły miejsca w dowolnym języku (preferowane są język angielski, jeśli takie informacje istnieją).

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

string

Kod Unicode kraju/regionu (CLDR) lokalizacji, z której pochodzi żądanie. Służy on do wyświetlania szczegółowych informacji o miejscu, takich jak nazwa miejsca z danego regionu, jeśli jest dostępna. Parametr może wpływać na wyniki w zależności od obowiązującego prawa.

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

Uwzględniony typ miejsca (np. „restauracja” lub „stacja benzynowa”) ze strony https://developers.google.com/maps/documentation/places/web-service/place-types.

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

Jeśli występują jakieś sprzeczne typy, tj. dany typ występuje zarówno w atrybutach include_types, jak iexcluded_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z wieloma ograniczeniami dotyczącymi typu, zwracane są tylko miejsca, które spełniają wszystkie te ograniczenia. Jeśli np. uwzględnimy: {included_types = ["restauracja"], excluded_primary_types = ["restauracja"]}, zwrócone miejsca świadczą usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.
excluded_types[]

string

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

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

Jeśli klient poda zarówno parametry include_types (np. restauracja), jak i wykluczone typy (np. kafejka), w odpowiedzi powinna znaleźć się informacja o miejscach będących restauracją, ale nie kawiarnią. Odpowiedź zawiera miejsca, które pasują do co najmniej jednego z parametrów include_types i żadnego z wykluczonych typów.

Jeśli występują jakieś sprzeczne typy, tj. dany typ występuje zarówno w atrybutach include_types, jak iexcluded_types, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ miejsca jest określony z wieloma ograniczeniami dotyczącymi typu, zwracane są tylko miejsca, które spełniają wszystkie te ograniczenia. Jeśli np. uwzględnimy: {included_types = ["restauracja"], excluded_primary_types = ["restauracja"]}, zwrócone miejsca świadczą usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.
included_primary_types[]

string

Uwzględniono główny typ miejsca (np. „restauracja” lub „stacja benzynowa”) ze strony https://developers.google.com/maps/documentation/places/web-service/place-types. Miejsce może mieć tylko 1 typ podstawowy z powiązanej z nim tabeli obsługiwanych typów.

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

Jeśli występują kolidujące typy podstawowe, tj. dany typ występuje zarówno w atrybutach include_primary_types, jak iexcluded_primary_types, zwraca błąd NEPRAWY.

Jeśli typ miejsca jest określony z wieloma ograniczeniami dotyczącymi typu, zwracane są tylko miejsca, które spełniają wszystkie te ograniczenia. Jeśli np. uwzględnimy: {included_types = ["restauracja"], excluded_primary_types = ["restauracja"]}, zwrócone miejsca świadczą usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.
excluded_primary_types[]

string

Wykluczony główny typ miejsca (np. „restauracja” lub „stacja benzynowa”) ze strony https://developers.google.com/maps/documentation/places/web-service/place-types.

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

Jeśli występują kolidujące typy podstawowe, tj. dany typ występuje zarówno w atrybutach include_primary_types, jak iexcluded_primary_types, zwraca błąd NEPRAWY.

Jeśli typ miejsca jest określony z wieloma ograniczeniami dotyczącymi typu, zwracane są tylko miejsca, które spełniają wszystkie te ograniczenia. Jeśli np. uwzględnimy: {included_types = ["restauracja"], excluded_primary_types = ["restauracja"]}, zwrócone miejsca świadczą 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 mieścić się w przedziale od 1 do 20 (domyślnie) włącznie. Jeśli wartość jest nieskonfigurowana, wraca do górnego limitu. Jeśli liczba jest ustawiona na ujemną lub przekracza górny limit, zwracany jest błąd INVALID_ARGUMENT.
location_restriction

LocationRestriction

Wymagane. Region do przeszukania.
rank_preference

RankPreference

sposób ustalania kolejności wyników w odpowiedzi;

LocationRestriction

Region do przeszukania.

Pola

Pole sumy type.

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

Circle

Okrąg określony przez punkt środkowy i promień.

RankPreference

sposób ustalania kolejności wyników w odpowiedzi;

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED Nie ustawiono wartości RankPreference. Domyślnie używana jest pozycja według POPULARNOŚCI.
DISTANCE Ranking wyników według odległości.
POPULARITY Ranking wyników według popularności.

SearchNearbyResponse

Protokół odpowiedzi na wyszukiwanie w pobliżu.

Pola
places[]

Place

Lista miejsc, które spełniają wymagania użytkownika, takie jak typ miejsc, liczba miejsc i konkretne ograniczenia lokalizacji.

SearchTextRequest

Żądanie proto dla 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 dostępny). Jeśli kod języka jest nieokreślony lub nierozpoznany, mogą zostać zwrócone szczegóły miejsca w dowolnym języku (preferowane są język angielski, jeśli takie informacje istnieją).

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

string

Kod Unicode kraju/regionu (CLDR) lokalizacji, z której pochodzi żądanie. Służy on do wyświetlania szczegółowych informacji o miejscu, takich jak nazwa miejsca z danego regionu, jeśli jest dostępna. Parametr może wpływać na wyniki w zależności od obowiązującego prawa.

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 ustalania kolejności wyników w odpowiedzi;
included_type

string

Żądany typ miejsca. Pełna lista obsługiwanych typów: https://developers.google.com/maps/documentation/places/web-service/place-types. Obsługują tylko jeden uwzględniony typ.
open_now

bool

Służy do ograniczenia wyszukiwania do obecnie otwartych miejsc. Wartość domyślna to false (fałsz).
min_rating

double

Odfiltrowuje wyniki, których średnia ocena użytkowników jest wyraźnie niższa od tego limitu. Prawidłowa wartość musi być liczbą zmiennoprzecinkową między 0 a 5 (włącznie) z częstotliwością 0,5, tj. [0, 0,5; 1,0; ... , 5,0] włącznie. Ocena danych wejściowych zostanie zaokrąglona w górę do najbliższej wielokrotności 0,5(skala). Na przykład ocena 0,6 eliminuje wszystkie wyniki z oceną mniejszą niż 1,0.
max_result_count
(deprecated)

int32

Wycofane: użyj zasady 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 parametr next_page_token, który może zostać przekazany do page_token w celu wyświetlenia następnej strony wyników w kolejnych żądaniach. Jeśli nie podasz wartości 0 lub nie podasz żadnej, stosowana będzie wartość domyślna, czyli 20. Maksymalna wartość to 20, a wartości powyżej 20 zostaną zmienione na 20. Wartości ujemne zwrócą błąd INVALID_ARGUMENT.

Jeśli podasz zarówno wartość max_result_count, jak i page_size, parametr max_result_count będzie ignorowany.
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 parametr next_page_token, który może zostać przekazany do page_token w celu wyświetlenia następnej strony wyników w kolejnych żądaniach. Jeśli nie podasz wartości 0 lub nie podasz żadnej, stosowana będzie wartość domyślna, czyli 20. Maksymalna wartość to 20, a wartości powyżej 20 zostaną ustawione na 20. Wartości ujemne zwrócą błąd INVALID_ARGUMENT.

Jeśli podasz zarówno wartość max_result_count, jak i page_size, parametr max_result_count będzie ignorowany.
page_token

string

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

Podczas podziału na strony wszystkie parametry inne niż page_token, page_size i max_result_count podane w TextSearch muszą być zgodne z początkowym wywołaniem, które podał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ć dowolne kombinacje poziomów cen. Domyślnie wybierz wszystkie poziomy cen.
strict_type_filtering

bool

Służy do ustawiania rygorystycznego filtrowania typów dla atrybutuinclude_type. Jeśli zasada ma wartość Prawda, zwracane są tylko wyniki tego samego typu. Wartość domyślna to fałsz.
location_bias

LocationBias

Region do przeszukania. Lokalizacja jest odchyleniem, co oznacza, że mogą być zwracane wyniki dotyczące jej okolicy. Nie można go ustawić razem z ograniczeniem location_restriction.
location_restriction

LocationRestriction

Region do przeszukania. Ta lokalizacja jest ograniczeniem, co oznacza, że wyniki spoza danej lokalizacji nie będą zwracane. Nie można go podać razem z atrybutem location_bias.
ev_options

EVOptions

Opcjonalnie. Ustaw opcje EV z możliwością wyszukiwania w żądaniu wyszukiwania miejsc.

EVOptions

Opcje EV z możliwością wyszukiwania w ramach żądania wyszukiwania miejsca.

Pola
minimum_charging_rate_kw

double

Opcjonalnie. Minimalna wymagana szybkość ładowania w kilowatach. Miejsca, w których szybkość ładowania jest niższa niż określona, zostanie odfiltrowana.
connector_types[]

EVConnectorType

Opcjonalnie. Lista preferowanych typów złączy EV. Miejsce, które nie obsługuje żadnego z wymienionych typów oprogramowania sprzęgającego, zostanie odfiltrowane.

LocationBias

Region do przeszukania. Lokalizacja jest odchyleniem, co oznacza, że mogą być zwracane wyniki dotyczące jej okolicy.

Pola

Pole sumy type.

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

Viewport

Prostokątny prostokąt wyznaczony przez północno-wschodni róg. rectangle.high() musi być północno-wschodnim punktem widocznego obszaru prostokąta. rectangle.low() musi być południowo-zachodnim punktem widocznego obszaru w prostokącie. Wartość w polu rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to pusty zakres szerokości geograficznej. Widoczny obszar prostokątny nie może być szerszy niż 180 stopni.
circle

Circle

Okrąg określony przez punkt środkowy i promień.

LocationRestriction

Region do przeszukania. Ta lokalizacja jest ograniczeniem, co oznacza, że wyniki spoza danej lokalizacji nie będą zwracane.

Pola

Pole sumy type.

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

Viewport

Prostokątny prostokąt wyznaczony przez północno-wschodni róg. rectangle.high() musi być północno-wschodnim punktem widocznego obszaru prostokąta. rectangle.low() musi być południowo-zachodnim punktem widocznego obszaru w prostokącie. Wartość w polu rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to pusty zakres szerokości geograficznej. Widoczny obszar prostokątny nie może być szerszy niż 180 stopni.

RankPreference

sposób ustalania kolejności wyników w odpowiedzi;

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED W przypadku zapytania kategorialnego, takiego jak „Restauracje w Krakowie”, domyślna wartość to RELEVANCE. W przypadku zapytań niedotyczących kategorii, takich jak „Mountain View, CA”, zalecamy pozostawienie nieskonfigurowanej pozycji rankingPreference.
DISTANCE Ranking wyników według odległości.
RELEVANCE Ranking wyników według trafności. Kolejność sortowania jest określana przez normalny stos rankingowy.

SearchTextResponse

Protokół odpowiedzi dla SearchText.

Pola
places[]

Place

Lista miejsc, które spełniają kryteria wyszukiwania tekstowego użytkownika.
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 wiąże się z odpowiednim miejscem w tym samym indeksie w polu miejsc. Preferowane są treści, które dotyczą elementu text_query w żądaniu. Jeśli treść kontekstowa jest niedostępna w jednym z miejsc, wróci do wyświetlenia treści niezwiązane z kontekstem. Będzie puste tylko wtedy, gdy treść jest niedostępna dla tego miejsca. Ta lista powinna zawierać tyle wpisów, co lista 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 to pole zostanie pominięte lub puste, nie będzie dalszych stron.