Rechercher des destinations

Développeurs de l'Espace économique européen (EEE)

A Destination fait référence à un point d'intérêt important ou à un lieu spécifique qu'un utilisateur a l'intention d'atteindre ou vers lequel il souhaite se rendre. Une Destination peut inclure des informations telles que des points de navigation, des points de repère, des entrées et des contours de bâtiments.

La SearchDestinations méthode de l'API Geocoding vous permet de récupérer des informations détaillées sur différentes destinations en fonction de différents critères d'entrée, tels qu'une adresse, un ID de lieu ou des coordonnées de latitude et de longitude.

Requête de recherche de destinations

Une requête de recherche de destinations est une requête HTTP POST envoyée à une URL au format suivant :

https://geocode.googleapis.com/v4/geocode/destinations

Transmettez tous les paramètres dans le corps de la requête JSON ou dans les en-têtes dans le cadre de la requête POST. Exemple :

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Vous pouvez spécifier l'emplacement dans lequel rechercher une destination de trois manières :

  • Adresse
  • ID de lieu
  • Coordonnées (latitude et longitude)

Rechercher une destination par adresse

Vous pouvez spécifier l'adresse sous forme de chaîne non structurée. Le geocoding d'adresse ne résout pas les coordonnées de latitude et de longitude, ni les autres chaînes non structurées qui ne représentent pas une adresse. Les requêtes utilisant de telles chaînes ne sont pas acceptées et peuvent entraîner des réponses d'erreur ou un comportement non spécifié. Voici quelques exemples de requêtes non acceptées :

Type de requête Exemple
Coordonnées (latitude et longitude). Utilisez plutôt une requête de lieu. "37.422131,-122.084801"
Trop de concepts ou de contraintes, tels que les noms de plusieurs lieux, routes ou villes dans une seule requête "Market Street San Francisco San Jose Airport"
Éléments d'adresse postale non représentés sur Google Maps "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
Noms d'entreprises, de chaînes ou de catégories combinés à des lieux où ces entités ne sont pas disponibles "Tesco near Dallas, Texas"
Requêtes ambiguës avec plusieurs interprétations "Charger drop-off"
Noms historiques qui ne sont plus utilisés "Middlesex United Kingdom"
Éléments ou intention non géospatiaux "How many boats are in Ventura Harbor?"
Noms non officiels ou personnalisés "The Jenga"
"The Helter Skelter"
Grandes entités politiques (villes, États, pays) "New York City"
"California"
"USA"
Itinéraires sans adresse spécifique "1st Ave., NYC, NY"
"I-95" 
curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

ou sous forme de postalAddress :

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Vous utilisez généralement le format postalAddress lorsque vous traitez des composants d'adresse capturés dans un formulaire HTML.

Rechercher une destination par ID de lieu

Vous pouvez récupérer une destination en fournissant un ID de lieu :

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

ID de lieu acceptés

La méthode Search Destinations fonctionne mieux avec les ID de lieu qui représentent des destinations spécifiques et navigables. Les ID de lieu pour des types tels que establishment, point_of_interest, premise, street_address, et subpremise sont généralement acceptés. Les ID de lieu qui ne représentent pas des lieux distincts, tels que ceux déduits de plages d'adresses (par exemple, "10-20 Main St"), les sections d'un itinéraire sans numéro spécifique ou les Plus Codes ne sont pas acceptés. Les ID de lieu pour les résultats dont la zone est trop grande (par exemple, "Océan Pacifique") ne sont pas non plus acceptés.

Utiliser Places API Autocomplete (New) avec Search Destinations

Pour garantir la compatibilité, utilisez Places API Autocomplete (New) pour trouver des ID de lieu à utiliser avec Search Destinations. Lorsque vous utilisez Autocomplete, vous devez filtrer les résultats par type à l'aide du includedPrimaryTypes paramètre. Les ID de lieu renvoyés par Autocomplete à l'aide du filtre recommandé suivant sont acceptés par Search Destinations :

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

De plus, vous ne devez pas définir l'include_pure_service_area_businesses indicateur sur true dans votre requête Autocomplete.

Rechercher une destination par lieu

Vous pouvez rechercher une destination en fournissant des coordonnées de latitude et de longitude :

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Utiliser OAuth pour effectuer une requête

L'API Geocoding v4 est compatible avec OAuth 2.0 pour l'authentification. Pour utiliser OAuth avec l'API Geocoding, le jeton OAuth doit être associé au champ d'application approprié. L'API Geocoding est compatible avec les champs d'application suivants pour une utilisation avec la méthode Destinations :

  • https://www.googleapis.com/auth/maps-platform.geocode : à utiliser avec toutes les méthodes de l'API Geocoding.

Vous pouvez également utiliser le champ d'application général https://www.googleapis.com/auth/cloud-platform pour toutes les méthodes de l'API Geocoding. Ce champ d'application est utile lors du développement, mais pas en production, car il s'agit d'un champ d'application général qui permet d'accéder à toutes les méthodes.

Pour en savoir plus et obtenir des exemples, consultez Utiliser OAuth.

Réponse de recherche de destinations

La réponse de recherche de destinations fournit un contexte riche et hyper localisé sur le lieu.

Cette section décrit les principaux champs de réponse. Pour obtenir des informations complètes sur tous les champs de réponse, consultez la documentation de référence de l'API.

primary

Lieu principal identifié par la requête dans la requête.

containingPlaces

Entités plus grandes dont la destination principale fait partie (par exemple, un centre commercial contenant un magasin).

subDestinations

Lieux plus spécifiques au sein de la destination principale (par exemple, des appartements dans un immeuble).

entrances

Les objets du tableau entrances[] comportent les champs suivants :

  • location

    Paire unique de coordonnées de latitude et de longitude qui définit l'emplacement d'un point d'entrée et de sortie dans un lieu.

  • entrance_tags[]

    Tableau de tags d'entrée qui décrit les caractéristiques de l'entrée. La valeur suivante est acceptée :

    • "PREFERRED"

    Indique que cette entrée permet probablement d'accéder physiquement au lieu renvoyé. Un lieu peut avoir plusieurs entrées préférées. Si une entrée ne comporte pas ce tag, cela signifie qu'elle se trouve physiquement dans le même bâtiment, mais qu'elle ne permet pas nécessairement d'accéder au lieu.

    Par exemple, si le lieu renvoyé est un restaurant dans un centre commercial, les "PREFERRED" entrées seront celles qui mènent au restaurant lui-même, tandis que les autres entrées renvoyées seront d'autres entrées du bâtiment, telles que celles d'autres restaurants du centre commercial.

    Si le lieu renvoyé est un bâtiment lui-même, les "PREFERRED" entrées seront celles qui mènent à la partie "principale" du bâtiment. Par exemple, dans un centre commercial, les entrées "PREFERRED" seront celles qui permettent d'accéder au hall principal, mais si une entrée ne permet d'accéder qu'à un magasin situé sur le côté du bâtiment, il ne s'agira pas d'une entrée "PREFERRED".

structureType

Type de structure que ce lieu représente.

  • POINT

    Lieu ponctuel.

  • SECTION

    Sous-section d'un bâtiment.

  • BUILDING

    Bâtiment.

  • GROUNDS

    Grande zone contenant généralement plusieurs bâtiments, comme un campus universitaire, un complexe d'appartements ou un centre commercial.

Le champ navigationPoints de la réponse Geocoding contient une liste de points utiles pour se rendre au lieu. Plus précisément, ils doivent être utilisés comme points de départ ou d'arrivée lors de l'itinéraire sur un réseau routier depuis ou vers le lieu. Chaque point de navigation contient les valeurs suivantes :

  • navigationPointToken est un jeton contenant les informations contextuelles dans le champ navigationPoints. Vous pouvez envoyer ce jeton aux API de routage et de navigation pour améliorer le routage et l'expérience de navigation dans votre application. Pour en savoir plus, consultez Itinéraire à l'aide de jetons de point de navigation pour plus d'informations.
  • location contient la valeur de latitude et de longitude du point de navigation. Ce lieu sera toujours très proche du réseau routier et représente un point d'arrêt ou de départ idéal pour se rendre à un lieu et en revenir. Le point est intentionnellement légèrement décalé par rapport à l'axe de la route pour marquer clairement le côté de la route où se trouve le lieu.
  • travelModes est une liste des modes de transport accessibles depuis le point de navigation :
    • "DRIVE" est le mode de transport correspondant aux itinéraires en voiture.
    • "WALK" est le mode de transport correspondant aux itinéraires à pied.
  • usages est une liste des utilisations acceptées par le point de navigation. Les utilisations peuvent être les suivantes :
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

arrivalSummary

Insights optimisés par l'IA pour faciliter l'arrivée. Consultez Résumés optimisés par l'IA.

landmarks

Lieux remarquables à proximité pour aider les utilisateurs à comprendre les environs de la destination.

Format de réponse

SearchDestinations renvoie un SearchDestinationsResponse au format JSON suivant :

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "meal_takeaway",
          "food_delivery",
          "american_restaurant",
          "restaurant",
          "food_store",
          "store",
          "food",
          "point_of_interest",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 61.182193756103516,
          "travelDistanceMeters": 63.075645446777344
        },
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "butcher_shop",
              "florist",
              "deli",
              "supermarket",
              "bakery",
              "food_delivery",
              "market",
              "manufacturer",
              "food_store",
              "store",
              "food",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 158.65606689453125,
          "travelDistanceMeters": 131.1669921875
        },
        {
          "place": {
            "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk",
            "displayName": {
              "text": "Oil Changers",
              "languageCode": "en"
            },
            "types": [
              "car_repair",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1240 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743054,
              "longitude": -122.0584272
            }
          },
          "relationalDescription": {
            "text": "Down the road from Oil Changers",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL"
          ],
          "straightLineDistanceMeters": 140.52459716796875,
          "travelDistanceMeters": 143.24220275878906
        },
        {
          "place": {
            "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0",
            "displayName": {
              "text": "Apni Mandi Farmers Market Sunnyvale",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "cake_shop",
              "supermarket",
              "asian_grocery_store",
              "indian_restaurant",
              "meal_takeaway",
              "bakery",
              "manufacturer",
              "wholesaler",
              "restaurant",
              "food_store",
              "store",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1056",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1111 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3737199,
              "longitude": -122.0522958
            }
          },
          "relationalDescription": {
            "text": "Near Apni Mandi Farmers Market Sunnyvale",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 410.37435913085938,
          "travelDistanceMeters": 479.49893188476562
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "primaryType": "chicken_restaurant",
            "types": [
              "chicken_restaurant",
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": {
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ],
              "type": "Polygon"
            }
          },
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 87.348007202148438,
          "travelDistanceMeters": 214.08084106445312
        }
      ],
      "entrances": [
        {
          "location": {
            "latitude": 37.3735328,
            "longitude": -122.05694879999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4",
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "PARKING"
          ]
        }
      ]
    }
  ]
}

Paramètres obligatoires

  • L'un des trois paramètres suivants doit figurer dans la requête API, qui spécifie l'adresse, le lieu ou l'emplacement dans lequel rechercher une destination :
    • addressQuery : adresse à rechercher.
    • place : ID de lieu à rechercher.
    • locationQuery : coordonnées de latitude et de longitude de l'emplacement à rechercher.

  • FieldMask

    Spécifiez la liste des champs à renvoyer dans la réponse en créant un masque de champ de réponse. Transmettez le masque de champ de réponse à la méthode à l'aide du paramètre d'URL $fields ou fields, ou à l'aide de l'en-tête HTTP X-Goog-FieldMask. Par exemple, la requête ci-dessous ne renverra que les entrées, les points de navigation et l'ID de lieu de la destination principale.

      curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
    -H "X-Goog-Api-Key: API_KEY" \
    -H "Content-Type: application/json" \
    -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
    https://geocode.googleapis.com/v4/geocode/destinations

    Il n'existe pas de liste par défaut de champs renvoyés dans la réponse. Si vous omettez le masque de champ, la méthode renvoie une erreur. Définissez le masque de champ sur * pour renvoyer tous les champs. Pour en savoir plus, consultez Choisir les champs à renvoyer.

Paramètres facultatifs

  • travelModes

    Spécifie les types de navigationPoints à renvoyer. Les points de navigation pour les autres modes de transport seront filtrés. Si travelModes n'est pas défini, les points de navigation de tous les modes de transport peuvent être renvoyés.

  • languageCode

    Langue dans laquelle renvoyer les résultats.

    • Consultez la liste des langues acceptées. Google met souvent à jour les langues acceptées. Cette liste n'est donc pas exhaustive.
    • Si languageCode n'est pas fourni, l'API utilise en par défaut. Si vous spécifiez un code de langue non valide, l'API renvoie une INVALID_ARGUMENT erreur.
    • L'API fait de son mieux pour fournir une adresse postale lisible pour l'utilisateur et les habitants. Pour atteindre cet objectif, elle renvoie les adresses postales dans la langue locale, translittérées dans un script lisible par l'utilisateur si nécessaire, en respectant la langue préférée. Toutes les autres adresses sont renvoyées dans la langue préférée. Les composants d'adresse sont tous renvoyés dans la même langue, qui est choisie à partir du premier composant.
    • Si un nom n'est pas disponible dans la langue préférée, l'API utilise la correspondance la plus proche.
    • La langue préférée a une faible influence sur l'ensemble des résultats que l'API choisit de renvoyer et sur l'ordre dans lequel ils sont renvoyés. Le géocoder interprète les abréviations différemment selon la langue, par exemple les abréviations des types de rues ou les synonymes qui peuvent être valides dans une langue, mais pas dans une autre.

  • regionCode

    Code de région sous forme de valeur de code CLDR à deux caractères. Il n'existe pas de valeur par défaut. La plupart des codes CLDR sont identiques aux codes ISO 3166-1.

    Lors du geocoding d'une adresse, geocoding direct, ce paramètre peut influencer, mais pas limiter totalement, les résultats du service à la région spécifiée. Lors du geocoding d'un lieu ou d'un établissement, geocoding inversé ou geocoding de lieu, ce paramètre peut être utilisé pour mettre en forme l'adresse. Dans tous les cas, ce paramètre peut affecter les résultats en fonction de la loi applicable.

  • placeFilter

    Vous permet de filtrer les résultats d'une locationQuery recherche pour répondre à vos besoins, par exemple en ne renvoyant que les destinations qui sont des bâtiments ou uniquement celles qui ont des adresses claires.

    Filtrer par granularité structurelle

    Le filtre structureType vous permet de spécifier le type de structures renvoyées par la requête :

    • Isoler des bâtiments : utilisez "structureType": "BUILDING" pour afficher les contours des bâtiments sur une carte ou obtenir des informations sur une structure spécifique.
    • Comprendre les complexes : utilisez "structureType": "GROUNDS" pour vous assurer que le résultat principal correspond à l'ensemble du terrain. Cela est utile lorsque vous interrogez des zones plus vastes, comme des campus universitaires ou des centres commerciaux.
    • Se concentrer sur les unités/sections : utilisez "structureType": "SECTION" pour identifier les sections d'un bâtiment.

    S'assurer d'avoir des adresses utiles

    Tous les lieux n'ont pas d'adresse claire au niveau de la rue. Le filtre addressability vous permet de contrôler la qualité des adresses dans vos résultats :

    • Exiger une adresse principale claire : pour vous assurer que le résultat de la destination principale comporte toujours une adresse ou un nom au niveau de la rue, utilisez "addressability": "PRIMARY". Cela est utile à des fins de navigation ou d'affichage lorsqu'une adresse claire est essentielle.
    • Autoriser les adresses dans les sous-destinations : dans les cas où le lieu principal n'a pas d'adresse, mais où les unités qu'il contient en ont une (comme les appartements dans un immeuble), "addressability": "WEAK" garantit qu'au moins le lieu principal ou l'une de ses sous-destinations possède une adresse.
    • Tout résultat : si la présence d'une adresse n'est pas pertinente pour votre cas d'utilisation, utilisez "addressability": "ANY".
    Exemple : Filtrer les bâtiments adressables 
    curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    },
    "placeFilter": {
      "structureType": "BUILDING",
      "addressability": "PRIMARY"
    }
  },
  "languageCode": "en"
}' \\
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
-H "X-Goog-FieldMask: place" \\
https://geocode.googleapis.com/v4/geocode/destinations