GeocodeResult

Un résultat de geocoding contient des informations géographiques sur un lieu.

Représentation 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)
  }
}
Champs
place

string

ACTION REQUISE pour les utilisateurs de la version 4alpha/4beta : ce champ sera bientôt mis à jour. L'ancien format "//places.googleapis.com/places/{placeID}" sera remplacé par le nouveau format "places/{placeId}". Assurez-vous que votre application peut gérer les deux formats pendant la période de transition. L'ancien format devrait être complètement obsolète d'ici fin mai 2026.

Identifiant de lieu complet pour ce résultat. Au format "//places.googleapis.com/places/{placeID}". Pour en savoir plus, consultez la page https://developers.google.com/maps/documentation/places/web-service/place-id.

placeId

string

Identifiant unique d'un lieu.

location

object (LatLng)

Latlng de cette adresse.

granularity

enum (GeocodeResult.Granularity)

Granularité de l'emplacement.

viewport

object (Viewport)

Fenêtre d'affichage adaptée à l'affichage du résultat de geocoding.

bounds

object (Viewport)

Cadre de délimitation de l'adresse.

formattedAddress

string

Adresse mise en forme sur une seule ligne.

postalAddress

object (PostalAddress)

Adresse au format postal.

addressComponents[]

object (GeocodeResult.AddressComponent)

Composants répétés pour chaque niveau de localité.

postalCodeLocalities[]

object (LocalizedText)

Liste complète des localités contenues dans le code postal.

Ce champ n'est renseigné que lorsque le résultat est de type "postal_code".

types[]

string

Ensemble de tags de type pour ce résultat. Par exemple, "political" et "administrative_area".

Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B sur la page https://developers.google.com/maps/documentation/places/web-service/place-types.

plusCode

object (PlusCode)

Plus Code de l'emplacement dans ce geocode.

GeocodeResult.AddressComponent

Composants structurés qui forment l'adresse mise en forme, si ces informations sont disponibles.

Représentation JSON
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Champs
longText

string

Description complète ou nom du composant d'adresse. Par exemple, un composant d'adresse pour le pays "Australie" peut avoir le nom long "Australie".

shortText

string

Nom textuel abrégé pour le composant d'adresse, s'il est disponible. Par exemple, un composant d'adresse pour le pays "Australie" peut avoir le nom court "AU".

types[]

string

Tableau indiquant le ou les types du composant d'adresse.

Pour en savoir plus, consultez la page https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.

languageCode

string

Langue utilisée pour mettre en forme ce composant, en notation CLDR.