GeocodeResult
Stay organized with collections
Save and categorize content based on your preferences.
A geocode result contains geographic information about a place.
| JSON representation |
{
"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)
}
} |
GeocodeResult.AddressComponent
The structured components that form the formatted address, if this information is available.
| JSON representation |
{
"longText": string,
"shortText": string,
"types": [
string
],
"languageCode": string
} |
| Fields |
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".
|
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".
|
types[] |
string
An array indicating the type(s) of the address component. See https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types for more details.
|
languageCode |
string
The language used to format this components, in CLDR notation.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 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. |"]]
