Rechercher des destinations

Une Destination désigne un lieu ou un emplacement spécifique qu'un utilisateur souhaite atteindre ou vers lequel il souhaite naviguer. Un Destination inclut également un ensemble d'informations liées au lieu ou à l'endroit, telles que des points de navigation, des points de repère, des entrées et des contours de bâtiments.

La méthode SearchDestinations 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 POST HTTP 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 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 de recherche d'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 géocodage 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 compatibles :

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 en tant que 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 les 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 emplacements distincts, tels que ceux déduits de plages d'adresses (par exemple, "10-20 Main St"), de sections d'un itinéraire sans numéro spécifique ou de 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 Autocomplete (New) avec Search Destinations

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

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

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

Rechercher une destination par lieu

Vous pouvez rechercher un lieu à partir de ses coordonnées (latitude et 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 se voir attribuer le bon niveau d'accès. 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 pendant le 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 la recherche de destinations

La réponse Search Destinations fournit un contexte hyper-local enrichi sur le lieu.

Les objets PlaceView de la réponse Search Destinations (tels que primary, les éléments de containingPlaces et landmarks) utilisent des champs pour indiquer le type de lieu :

• types : tableau de chaînes indiquant le ou les types du lieu.
• primaryType : chaîne indiquant le type principal du lieu.

Les valeurs de chaîne possibles pour types et primaryType sont extraites du Tableau A et du Tableau B de la page "Types de lieux (New)".

Cette section décrit les principaux champs de réponse. Pour en savoir plus sur tous les champs de réponse, consultez la documentation de référence de l'API.

primary

Le lieu principal identifié par la requête.

addressComponents

Tableau contenant les composants distincts applicables à cette adresse.

Chaque composant d'adresse contient généralement les champs suivants :

• types[] est un tableau indiquant le type du composant d'adresse. Consultez la liste des types compatibles.
• longText est la description complète ou le nom du composant d'adresse renvoyé par le geocoder.
• shortText est un nom textuel abrégé pour le composant d'adresse, s'il est disponible. Par exemple, un composant d'adresse pour l'Alaska peut avoir "Alaska" comme longText et "AK" comme shortText, correspondant à l'abréviation postale de deux lettres.
• languageCode est la langue utilisée pour formater ce composant, en notation CLDR.

containingPlaces

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

subDestinations

Emplacements plus spécifiques au sein de la destination principale (par exemple, des appartements dans un bâtiment).

entrances

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

• displayName

  Objet LocalizedText contenant un nom lisible par l'humain pour l'entrée (par exemple, "South Bernardo Avenue" ou "5th Avenue"), si disponible.

• location

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

• entrance_tags[]

  Tableau de tags d'entrée décrivant 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 entrées "PREFERRED" 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, comme les entrées d'autres restaurants du centre commercial.

  Si le lieu renvoyé est un bâtiment, les entrées "PREFERRED" 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 sur le côté du bâtiment, il ne s'agira pas d'une entrée "PREFERRED".

• streetViewThumbnail et streetViewAnnotation

  Paramètres de l'API Street View Static, qui vous permettent d'afficher des images pertinentes pour ces lieux. En savoir plus sur ces champs

structureType

Type de structure que ce lieu représente.

• POINT

  Un point géographique.

• SECTION

  Sous-section d'un bâtiment.

• BUILDING

  Un bâtiment.

• GROUNDS

  Une grande zone qui contient généralement plusieurs bâtiments, comme un campus universitaire, un complexe d'appartements ou un centre commercial.

navigationPoints

Le champ navigationPoints de la réponse de géocodage contient une liste de points utiles pour accéder 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 du champ navigationPoints. Vous pouvez envoyer ce jeton aux API de routage et de navigation pour améliorer l'itinéraire et l'expérience de navigation dans votre application. Pour en savoir plus, consultez Calculer un itinéraire à l'aide de jetons de point de navigation.
• location contient la valeur latitude, longitude du point de navigation. Cet emplacement sera toujours très proche du réseau routier et représente un point d'arrêt ou de départ idéal pour naviguer vers et depuis un lieu. Le point est intentionnellement légèrement décalé par rapport à l'axe de la route pour indiquer clairement le côté de la route où se trouve le lieu.
• travelModes est une liste de modes de transport à partir desquels le point de navigation est accessible :
  • "DRIVE" est le mode de transport correspondant aux itinéraires en voiture.
  • "WALK" est le mode de transport correspondant à un itinéraire à pied.
• usages est une liste des utilisations compatibles avec le point de navigation. Les utilisations peuvent être les suivantes :
  • "DROPOFF"
  • "PICKUP"
  • "PARKING"

Pour les prises en charge et les déposes, utilisez le point de navigation où le mode de transport est DRIVE et l'utilisation est PICKUP ou DROPOFF. Si les points de prise en charge ou de dépose ne sont pas disponibles, utilisez le point de navigation routière principal.

• streetViewThumbnail et entranceAnnotation fournissent des paramètres pour l'API Street View Static, ce qui vous permet d'afficher des images pertinentes pour ces lieux. En savoir plus sur ces champs

• altitude_meters contient l'altitude du point de navigation en mètres par rapport à l'ellipsoïde WGS-84. Dans les cas où des segments de route sont empilés verticalement, utilisez le champ altitude_meters pour sélectionner le meilleur segment de route vers lequel votre système doit naviguer.

landmarks

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

Chaque point de repère contient les champs suivants :

• place est l'objet PlaceView qui représente ce repère.
• relationalDescription est une description lisible par l'humain de la relation entre la destination et le point de repère, par exemple "Près de l'Empire State Building" ou "En face de la Maison-Blanche".
• tags[] est un tableau de tags qui décrivent comment le repère peut être utilisé dans le contexte de la destination :
  • "ADDRESS" : lieu connu localement qui peut être utilisé pour identifier la position générale de la destination.
  • "ARRIVAL" : lieu qui peut être utilisé pour faciliter l'arrivée à destination, utile pour la navigation une fois à proximité de la destination.
• straightLineDistanceMeters est la distance en ligne droite entre ce repère et la destination, en mètres.
• travelDistanceMeters est la distance de marche entre ce point de repère et la destination, en mètres.

arrivalSummary

Insights optimisés par l'IA pour vous aider à l'arrivée. Consultez Résumés optimisés par l'IA.

parkingOptions

Informations détaillées sur le stationnement.

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": [
        {
          "displayName": {
            "text": "South Bernardo Avenue",
            "languageCode": "en"
          },
          "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 pour rechercher une destination :
  • addressQuery : adresse à rechercher.
  • place : ID de lieu à rechercher.
  • locationQuery : coordonnées de latitude et de longitude du lieu à 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 de l'en-tête HTTP X-Goog-FieldMask. Par exemple, la requête ci-dessous ne renvoie 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 des 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 les résultats doivent être renvoyés.

  • 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 par défaut la langue et l'écriture locales du lieu. Si vous spécifiez un code de langue non valide, l'API renvoie une erreur INVALID_ARGUMENT.
  • L'API s'efforce de fournir une adresse postale lisible à la fois pour l'utilisateur et pour 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 aucun nom n'est disponible dans la langue préférée, l'API utilise la correspondance la plus proche.
  • La langue préférée a une légère influence sur l'ensemble des résultats que l'API choisit de renvoyer et l'ordre dans lequel ils sont renvoyés. Le geocoder 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 la forme d'un 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 géocodage d'une adresse (géocodage direct), ce paramètre peut influencer, mais pas limiter complètement, les résultats du service à la région spécifiée. Lors du geocoding d'un lieu ou d'un endroit, du geocoding inversé ou du geocoding de lieu, ce paramètre peut être utilisé pour formater l'adresse. Dans tous les cas, ce paramètre peut affecter les résultats en fonction de la législation applicable.

• placeFilter

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

  Filtrer par niveau de précision structurel

  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 détails sur une structure spécifique.
  • Comprendre les complexes : utilisez "structureType": "GROUNDS" pour vous assurer que le résultat principal correspond à l'ensemble du terrain. Cette fonctionnalité est utile pour interroger des zones plus vastes, comme des campus universitaires ou des centres commerciaux.
  • Focus sur les unités/sections : utilisez "structureType": "SECTION" pour identifier les sections d'un bâtiment.

  S'assurer que les adresses sont utiles

  Tous les lieux ne disposent pas d'une adresse postale claire. Le filtre addressability vous aide à 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 pour la navigation ou l'affichage, où 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 que les unités qu'il contient en ont une (comme les appartements d'un immeuble), "addressability": "WEAK" s'assure qu'au moins le lieu principal ou l'une de ses sous-destinations possède une adresse.
  • Any Result : si la présence de l'adresse n'est pas pertinente pour votre cas d'utilisation, utilisez "addressability": "ANY". Cette option est vivement recommandée lorsque vous n'avez besoin que d'attributs géométriques tels que les contours des bâtiments et les points de navigation, car elle améliore la précision de ces résultats.
  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