GeocodeResult

Wynik geokodowania zawiera informacje geograficzne o miejscu.

Zapis JSON
{
  "place": string,
  "placeId": string,
  "location": {
    object (LatLng)
  },
  "granularity": enum (GeocodeResult.Granularity),
  "viewport": {
    object (Viewport)
  },
  "bounds": {
    object (Viewport)
  },
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (GeocodeResult.AddressComponent)
    }
  ],
  "postalCodeLocalities": [
    {
      object (LocalizedText)
    }
  ],
  "types": [
    string
  ],
  "plusCode": {
    object (PlusCode)
  }
}
Pola
place

string

WYMAGANE DZIAŁANIE w przypadku użytkowników wersji v4alpha/v4beta: to pole zostanie wkrótce zaktualizowane ze starego formatu „//places.googleapis.com/places/{placeID}” do nowego formatu „places/{placeId}”. W okresie przejściowym aplikacja musi obsługiwać oba formaty. Stary format zostanie całkowicie wycofany do końca maja 2026 r.

Pełny i jednoznaczny 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.

placeId

string

Unikalny identyfikator miejsca.

location

object (LatLng)

Współrzędne geograficzne tego adresu.

granularity

enum (GeocodeResult.Granularity)

Stopień szczegółowości lokalizacji.

viewport

object (Viewport)

obszar widoku odpowiedni do wyświetlania wyniku geokodowania;

bounds

object (Viewport)

Ramka ograniczająca adresu.

formattedAddress

string

Jednowierszowy sformatowany adres.

postalAddress

object (PostalAddress)

Adres w formacie adresu pocztowego.

addressComponents[]

object (GeocodeResult.AddressComponent)

Powtarzające się komponenty dla każdego poziomu lokalizacji.

postalCodeLocalities[]

object (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.

plusCode

object (PlusCode)

Kod Plus Code lokalizacji w tym geokodzie.

GeocodeResult.AddressComponent

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

Zapis JSON
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Pola
longText

string

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

shortText

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.

languageCode

string

Język użyty do sformatowania tego komponentu w notacji CLDR.