GeocodeResult
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Um resultado de geocodificação contém informações geográficas sobre um lugar.
Representação 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 )
}
} |
Campos |
place |
string
O identificador de lugar totalmente qualificado para este resultado. No formato "//places.googleapis.com/places/{placeID}". Consulte https://developers.google.com/maps/documentation/places/web-service/place-id para mais detalhes.
|
placeId |
string
O ID do lugar para este resultado.
|
location |
object (LatLng )
O latlng deste endereço.
|
granularity |
enum (GeocodeResult.Granularity )
A granularidade do local.
|
viewport |
object (Viewport )
Uma janela de visualização adequada para mostrar o resultado da geocodificação.
|
bounds |
object (Viewport )
Uma caixa delimitadora para o endereço.
|
formattedAddress |
string
O endereço formatado em uma linha.
|
postalAddress |
object (PostalAddress )
O endereço no formato de endereço postal.
|
addressComponents[] |
object (GeocodeResult.AddressComponent )
Componentes repetidos para cada nível de localidade.
|
postalCodeLocalities[] |
object (LocalizedText )
Lista completa de localidades contidas no código postal. Esse campo só é preenchido quando o resultado é do tipo "postal_code".
|
types[] |
string
Um conjunto de tags de tipo para este resultado. Por exemplo, "political" e "administrative_area". Para conferir a lista completa de valores possíveis, consulte as tabelas A e B em https://developers.google.com/maps/documentation/places/web-service/place-types.
|
plusCode |
object (PlusCode )
Plus Code do local nesta geocodificação.
|
GeocodeResult.AddressComponent
Os componentes estruturados que formam o endereço formatado, se essas informações estiverem disponíveis.
Representação JSON |
{
"longText": string,
"shortText": string,
"types": [
string
],
"languageCode": string
} |
Campos |
longText |
string
A descrição completa em texto ou o nome do componente do endereço. Por exemplo, um componente de endereço para o país Austrália pode ter o nome longo "Austrália".
|
shortText |
string
Um nome abreviado, no formato de texto, para o componente de endereço, se estiver disponível. Por exemplo, um componente de endereço para o país Austrália pode ter o nome abreviado "AU".
|
types[] |
string
Uma matriz que indica os tipos do componente de endereço. Consulte https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types para mais detalhes.
|
languageCode |
string
A linguagem usada para formatar esses componentes, na notação CLDR.
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[],[],null,["# GeocodeResult\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [GeocodeResult.AddressComponent](#GeocodeResult.AddressComponent)\n - [JSON representation](#GeocodeResult.AddressComponent.SCHEMA_REPRESENTATION)\n\nA geocode result contains geographic information about a place.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"place\": string, \"placeId\": string, \"location\": { object (/maps/documentation/geocoding/reference/rest/Shared.Types/LatLng) }, \"granularity\": enum (/maps/documentation/geocoding/reference/rest/v4beta/GeocodeResult.Granularity), \"viewport\": { object (/maps/documentation/geocoding/reference/rest/v4beta/Viewport) }, \"bounds\": { object (/maps/documentation/geocoding/reference/rest/v4beta/Viewport) }, \"formattedAddress\": string, \"postalAddress\": { object (/maps/documentation/geocoding/reference/rest/Shared.Types/PostalAddress) }, \"addressComponents\": [ { object (/maps/documentation/geocoding/reference/rest/v4beta/GeocodeResult#GeocodeResult.AddressComponent) } ], \"postalCodeLocalities\": [ { object (/maps/documentation/geocoding/reference/rest/Shared.Types/LocalizedText) } ], \"types\": [ string ], \"plusCode\": { object (/maps/documentation/geocoding/reference/rest/v4beta/PlusCode) } } ``` |\n\n| Fields ||\n|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `place` | `string` The fully qualified place identifier for this result. In the format of \"//places.googleapis.com/places/{placeID}\". See \u003chttps://developers.google.com/maps/documentation/places/web-service/place-id\u003e. for more details. |\n| `placeId` | `string` The place ID for this result. |\n| `location` | `object (`[LatLng](/maps/documentation/geocoding/reference/rest/Shared.Types/LatLng)`)` The latlng of this address. |\n| `granularity` | `enum (`[GeocodeResult.Granularity](/maps/documentation/geocoding/reference/rest/v4beta/GeocodeResult.Granularity)`)` The granularity of the location. |\n| `viewport` | `object (`[Viewport](/maps/documentation/geocoding/reference/rest/v4beta/Viewport)`)` A viewport suitable for displaying the geocode result. |\n| `bounds` | `object (`[Viewport](/maps/documentation/geocoding/reference/rest/v4beta/Viewport)`)` A bounding box for the address. |\n| `formattedAddress` | `string` The one line formatted address. |\n| `postalAddress` | `object (`[PostalAddress](/maps/documentation/geocoding/reference/rest/Shared.Types/PostalAddress)`)` The address in postal address format. |\n| `addressComponents[]` | `object (`[GeocodeResult.AddressComponent](/maps/documentation/geocoding/reference/rest/v4beta/GeocodeResult#GeocodeResult.AddressComponent)`)` Repeated components for each locality level. |\n| `postalCodeLocalities[]` | `object (`[LocalizedText](/maps/documentation/geocoding/reference/rest/Shared.Types/LocalizedText)`)` Complete list of localities contained in the postal code. This is only populated when the result is of type \"postal_code\". |\n| `types[]` | `string` A set of type tags for this result. For example, \"political\" and \"administrative_area\". For the complete list of possible values, see Table A and Table B at \u003chttps://developers.google.com/maps/documentation/places/web-service/place-types\u003e. |\n| `plusCode` | `object (`[PlusCode](/maps/documentation/geocoding/reference/rest/v4beta/PlusCode)`)` Plus code of the location in this geocode. |\n\nGeocodeResult.AddressComponent\n------------------------------\n\nThe structured components that form the formatted address, if this information is available.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------|\n| ``` { \"longText\": string, \"shortText\": string, \"types\": [ string ], \"languageCode\": string } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `longText` | `string` The full text description or name of the address component. For example, an address component for the country Australia may have a long name of \"Australia\". |\n| `shortText` | `string` An abbreviated textual name for the address component, if available. For example, an address component for the country of Australia may have a short name of \"AU\". |\n| `types[]` | `string` An array indicating the type(s) of the address component. See \u003chttps://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types\u003e for more details. |\n| `languageCode` | `string` The language used to format this components, in CLDR notation. |"]]