L'API Places est compatible avec Nearby Search : Si vous connaissez la fonctionnalité Nearby Search existante, la nouvelle version de Nearby Search apporte les modifications suivantes:
- La nouvelle fonctionnalité Nearby Search utilise des requêtes HTTP POST. Transmettre des paramètres dans le corps de la requête ou dans les en-têtes dans le cadre d'une requête HTTP POST requête. En revanche, avec Nearby Search, vous transmettez des paramètres d'URL à l'aide d'une requête HTTP GET.
- Le masquage du champ est obligatoire. Vous devez spécifier les champs à renvoyer dans la réponse. Il n'existe pas de liste par défaut des champs renvoyés. Si vous omettez de cette liste, les méthodes renvoient une erreur. Pour en savoir plus, consultez FieldMask.
- La nouvelle fonctionnalité Nearby Search prend en charge à la fois Clés API et OAuth comme mécanisme d'authentification.
- Seul le format de réponse JSON est accepté dans le nouveau Nearby Search
- Toutes les requêtes qui incluent une requête textuelle doivent désormais utiliser Text Search (nouvelle version) car Nearby Search (nouvelle version) ne prend pas en charge la saisie de texte.
- Format de réponse JSON pour Nearby Search (nouveau) Le format des API existantes a été modifié. Pour en savoir plus, consultez Migrez la réponse de l'API Places.
Le tableau suivant répertorie les paramètres des Nearby Search qui ont été renommés ou modifiés pour Nearby Search, ou des paramètres qui ne sont plus compatibles.
| Paramètre actuel | Nouveau paramètre | Remarques |
|---|---|---|
keyword |
Non compatible. Utilisez Text Search (nouvelle version) à la place. | |
language |
languageCode |
|
location |
locationRestriction |
Obligatoire. |
maxprice/minprice |
|
Non compatible. |
maxResultCount |
Nouveau paramètre. | |
opennow |
|
Non compatible. |
pagetoken |
Non compatible. | |
radius |
|
Utilisez locationRestriction maintenant. |
rankby |
rankPreference |
|
regionCode |
Nouveau paramètre. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Les nouveaux paramètres acceptent également plusieurs valeurs de type. L'API existante n'accepte qu'une seule valeur. |
Exemple de requête
L'exemple suivant de demande GET utilise
Nearby Search Dans cet exemple, vous demandez un fichier
réponse contenant des informations sur les lieux de type restaurant et transmet tous les
en tant que paramètres d'URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Avec Nearby Search (nouveau), vous effectuez une requête POST et transmettre tous les paramètres dans le corps de la requête JSON ou dans les en-têtes dans le cadre de la méthode POST. requête. Cet exemple utilise également un masque de champ afin que la réponse n'inclue que le Nom à afficher et adresse formatée du lieu:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby