Package google.maps.geocode.v4beta

Indeks

GeocodeService

Usługa do geokodowania.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Ta metoda wykonuje geokodowanie adresu, które mapuje adres na obiekt LatLng. Zawiera też uporządkowane informacje o adresie.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Ta metoda wykonuje geokodowanie lokalizacji, które mapuje obiekt LatLng na adres. Zawiera też uporządkowane informacje o adresie.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Ta metoda wyszukuje kod geograficzny za pomocą identyfikatora miejsca.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

GeocodeAddressRequest

Komunikat żądania dla GeocodeService.GeocodeAddress.

Pola
location_bias

GeocodeAddressRequest.LocationBias

Opcjonalnie. Region, w którym ma się odbywać wyszukiwanie. Ta lokalizacja służy jako punkt odniesienia, co oznacza, że mogą być zwracane wyniki w jej pobliżu.
language_code

string

Opcjonalnie. Język, w którym mają być zwracane wyniki.
region_code

string

Opcjonalnie. Kod regionu. Kod regionu określony jako dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Ten parametr wpływa na wyniki na podstawie obowiązujących przepisów. Ten parametr będzie też wpływać na wyniki z usługi, ale nie będzie ich w pełni ograniczać.
Pole unii address_input. Adres do geokodowania. address_input może mieć tylko jedną z tych wartości:
address_query

string

Nieuporządkowany adres do geokodowania.
address

PostalAddress

Uporządkowany adres do geokodowania w formacie adresu pocztowego.

LocationBias

Region, w którym ma się odbywać wyszukiwanie. Ta lokalizacja służy jako punkt odniesienia, co oznacza, że mogą być zwracane wyniki w jej pobliżu.

Pola
Pole unii type. Rodzaje odchyleń związanych z lokalizacją. type może mieć tylko jedną z tych wartości:
rectangle

Viewport

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

GeocodeAddressResponse

Wiadomość z odpowiedzią dla GeocodeService.GeocodeAddress.

Pola
results[]

GeocodeResult

Wynik geokodowania.

GeocodeLocationRequest

Wiadomość z prośbą o wywołanie GeocodeService.GeocodeLocation.

Pola
language_code

string

Opcjonalnie. Język, w którym mają być zwracane wyniki.
region_code

string

Opcjonalnie. Kod regionu. Kod regionu określony jako dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Ten parametr wpływa na wyniki na podstawie obowiązujących przepisów.
types[]

string

Opcjonalnie. Zestaw tagów typu, które ograniczają wyniki. Wyniki, które nie mają żadnego z określonych typów, zostaną usunięte.

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

GeocodeResult.Granularity

Opcjonalnie. Filtr zawierający co najmniej 1 wartość wyliczeniową określającą szczegółowość lokalizacji.
Pole unii location_input. Lokalizacja do geokodowania. location_input może mieć tylko jedną z tych wartości:
location_query

string

Lokalizacja w formacie „lat,lng”. Na przykład „64.7611872,-18.4705364”.
location

LatLng

Lokalizacja w formacie strukturalnym.

GeocodeLocationResponse

Wiadomość z odpowiedzią dla GeocodeService.GeocodeLocation.

Pola
results[]

GeocodeResult

Wynik geokodowania.
plus_code

PlusCode

Plus kod lokalizacji w żądaniu.

GeocodePlaceRequest

Wiadomość z prośbą o wywołanie funkcji GeocodeService.GeocodePlace.

Pola
place

string

Wymagany. Identyfikator miejsca do geokodowania w formacie places/{place}.
language_code

string

Opcjonalnie. Język, w którym mają być zwracane wyniki.
region_code

string

Opcjonalnie. Kod regionu. Kod regionu określony jako dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Ten parametr wpływa na wyniki na podstawie obowiązujących przepisów.

GeocodeResult

Wynik geokodowania zawiera informacje geograficzne o miejscu.

Pola
place

string

W pełni kwalifikowany identyfikator miejsca dla tego wyniku. W formacie „//places.googleapis.com/places/{placeID}”. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/place-id.
place_id

string

Identyfikator miejsca dla tego wyniku.
location

LatLng

Współrzędne geograficzne tego adresu.
granularity

GeocodeResult.Granularity

Stopień szczegółowości lokalizacji.
viewport

Viewport

Obszar widoczny odpowiedni do wyświetlenia wyniku geokodowania.
bounds

Viewport

Pole ograniczenia adresu.
formatted_address

string

Jednowierszowy sformatowany adres.
postal_address

PostalAddress

Adres w formacie adresu pocztowego.
address_components[]

GeocodeResult.AddressComponent

Powtarzane komponenty dla każdego poziomu lokalizacji.
postal_code_localities[]

LocalizedText

Pełna lista miejscowości w danym kodzie pocztowym.

To pole jest wypełniane tylko wtedy, gdy wynik jest typu „postal_code”.
types[]

string

Zestaw tagów typu dla tego wyniku. Na przykład „political” i „administrative_area”.

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

PlusCode

Kod Plus Code lokalizacji w tym geokodzie.

AddressComponent

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

Pola
long_text

string

Pełny tekst opisu lub nazwa komponentu adresu. Na przykład komponent adresu dla kraju Australia może mieć długą nazwę „Australia”.
short_text

string

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

string

Tablica wskazująca typy komponentu adresu.

Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.
language_code

string

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

Szczegółowość

Stopień szczegółowości lokalizacji.

Wartości w polu enum
GRANULARITY_UNSPECIFIED Nie używać.
ROOFTOP Nieinterpolowana lokalizacja rzeczywistej działki odpowiadająca dopasowanemu adresowi.
RANGE_INTERPOLATED Interpolowane z zakresu numerów ulic. Jeśli np. wiemy, że odcinek Amphitheatre Pkwy zawiera numery od 1600 do 1699, numer 1650 może znajdować się w połowie odległości między jego punktami końcowymi.
GEOMETRIC_CENTER Geometryczne centrum obiektu, dla którego mamy dane wielokątne.
APPROXIMATE Wszystkie pozostałe.

PlusCode

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

Pola
global_code

string

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

string

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