L'API Places (New) est un service Web qui renvoie des données de localisation JSON sur des établissements, des emplacements géographiques et des points d'intérêt. Elle est compatible avec Text Search (New), Nearby Search (New), Autocomplete (New), Place Details (New) et Place Photos (New).
API Places (nouvelle version) : informations clés
- Produit : API Places (New)
- Également appelée : API Places
- Catégorie : Lieux
- Plate-forme : service Web (REST)
- S'exécute sur : le serveur (code backend)
- Étape de lancement : GA
- Cycle de vie : Actif
- Présentation : Présentation de l'API Places (nouvelle version)
- Disponibilité régionale : monde entier. Les projets dont l'adresse de facturation se trouve dans l'EEE sont soumis aux conditions d'utilisation de Google Maps Platform pour l'EEE (à compter du 8 juillet 2025). Selon ces conditions, les contenus de l'API Places autres que la latitude, la longitude et les ID de lieu ne peuvent être utilisés avec aucune carte, sauf via le Kit UI pour Places. Les résumés des lieux, des avis et des régions optimisés par l'IA ne sont disponibles que dans certaines langues et régions.
API Places (nouvelle version) : quand l'utiliser ?
Utilisez l'API Places (nouvelle version) dans les cas suivants :
- Vous devez rechercher des lieux à partir d'un serveur à l'aide d'une requête textuelle (Text Search (New)) ou autour d'un emplacement (Nearby Search (New)).
- Vous avez besoin de prédictions de lieu ou de requête de saisie semi-automatique à partir d'un backend via Autocomplete (New).
- Vous disposez d'un ID de lieu et avez besoin d'informations telles que l'adresse, le numéro de téléphone, la note, les avis ou les photos.
- Vous avez besoin de résumés de lieux, d'avis ou de zones optimisés par l'IA pour un lieu.
Quand ne pas utiliser l'API Places (nouvelle version) :
- Vous créez une application Android native. Utilisez plutôt le SDK Places pour Android.
- Vous créez une application iOS native. Utilisez plutôt le SDK Places pour iOS.
- Vous créez une application Web pour navigateur et souhaitez que la bibliothèque Places soit chargée en JavaScript. Utilisez plutôt l'API Maps JavaScript.
API Places (New) : configuration
- Service à activer :
places.googleapis.com - Authentification : clé API, OAuth 2.0
- Premiers pas : Configurer l'API Places (nouvelle version)
- Documentation de référence : Documentation de référence de l'API Places (nouvelle version)
- Tarification : utilisation et facturation de l'API Places (New)
- Règles : Règles de l'API Places (nouvelle version)
- Notes de version : Notes de version de l'API Places (nouvelle version)
Packages officiels de l'API Places (nouvelle version) :
- npm :
@googlemaps/places - pypi :
google-maps-places - go :
cloud.google.com/go/maps
API Places (nouvelle version) : produits associés
- Remplace : API Places (ancienne version)
- Souvent utilisée avec : l'API Geocoding, l'API Routes, l'API Address Validation
API Places (nouvelle version) : erreurs courantes
- Problème : Place Details (New), Nearby Search (New) et Text Search (New) n'ont pas de liste par défaut des champs renvoyés. Les requêtes sans masque de champ renvoient une erreur. Correction : Transmettez un masque de champ de réponse avec le paramètre
fieldsou$fields, ou l'en-têteX-Goog-FieldMask. Consultez /maps/documentation/places/web-service/choose-fields. - Problème : Si le jeton de session Autocomplete (New) est omis ou réutilisé après la fin d'une session, chaque requête est facturée séparément en tant que SKU Autocomplete Requests. Correction : générez un nouveau jeton de session (UUID v4 recommandé) pour chaque session et terminez-la par une requête Place Details (New) ou Address Validation. Consultez /maps/documentation/places/web-service/place-session-tokens.
- Problème : Le code existant ou généré par l'IA qui appelle l'API Places (ancienne version) ou l'API Maps JavaScript
PlacesServicesur un projet où l'ancienne API n'est pas activée échoue avec l'erreurLegacyApiNotActivatedMapError. Correction : Migrez les appels vers l'API Places (nouvelle version) et incluez le masque de champ requis. Consultez /maps/legacy#LegacyApiNotActivatedMapError. - Problème : les ID de lieu stockés peuvent devenir obsolètes. Place Details (New) renvoie alors
NOT_FOUND(HTTP 404), et les ID incorrects ou tronqués renvoient HTTP 400INVALID_ARGUMENT. Correction : Actualisez les ID de lieu stockés datant de plus de 12 mois à l'aide d'une requête Place Details (New) qui ne demande que le champid(sans frais). Consultez /maps/documentation/places/web-service/place-id#refresh-id.
Ce que vous pouvez faire avec l'API Places (nouvelle version)
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
API Places (New) : IA générative
- Renvoie un résumé optimisé par l'IA des avis des utilisateurs pour un identifiant de lieu Google spécifié.
- Renvoie un résumé optimisé par l'IA de la zone et des services autour d'un identifiant de lieu Google spécifié pour une borne de recharge de véhicules électriques.
API Places (nouvelle version) : Places
- Affichez une liste de lieux et de détails sur les lieux en fonction d'une chaîne de requête.
- Renvoyez une liste de lieux et de détails sur les lieux à proximité d'un emplacement spécifique.
- Renvoie des résultats de saisie semi-automatique sur des lieux en fonction d'une chaîne de requête.
- Renvoie des informations détaillées sur un lieu spécifique.
- Renvoyer des photos d'un lieu spécifique Remarque : Affichez les attributions de l'auteur de chaque photo (le nom de l'auteur, associé à l'URI de son profil) avec la photo. Les règles Places de chaque plate-forme l'exigent, par exemple /maps/documentation/javascript/policies#photo-attributions et /maps/documentation/places/web-service/policies#photos-and-review.
- Redimensionner les photos de lieux
- Renvoyer les notes et les avis d'un lieu spécifique. Remarque : Dans le service Web de l'API Places (New), Place Details est une requête HTTP GET envoyée à https://places.googleapis.com/v1/places/{placeId} avec X-Goog-FieldMask (par exemple, rating,userRatingCount,reviews). Text Search, Nearby Search et Autocomplete utilisent POST. Sur Android, transmettez Place.Field.RATING, USER_RATING_COUNT et REVIEWS à PlacesClient.fetchPlace(). Sur iOS, transmettez GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal et GMSPlacePropertyReviews dans GMSFetchPlaceRequest.
- Spécifiez les champs de données inclus dans les réponses aux informations sur les lieux.
- Spécifiez les types de lieux à inclure dans les réponses d'informations sur les lieux.
- Renvoyez l'URI pour ouvrir la page d'informations d'un lieu dans Google Maps.
- Renvoie l'URI permettant d'ouvrir la page d'itinéraire dans Google Maps pour un lieu.
- Renvoie l'URI permettant d'ouvrir la page de rédaction d'un avis dans Google Maps pour un lieu.
- Renvoie l'URI permettant d'ouvrir la page des avis d'un lieu dans Google Maps.
- Renvoie l'URI permettant d'ouvrir la page des photos d'un lieu dans Google Maps.
- Renvoyer un résumé généré par l'IA pour un lieu spécifique
- Renvoyez un résumé de la zone optimisé par l'IA décrivant les lieux situés autour d'un lieu spécifique.
- Renvoie des informations sur les lieux situés le long d'un itinéraire prédéfini en fonction d'une chaîne de requête.
- Affichez la distance, le temps de trajet et l'URI de l'itinéraire vers les lieux de Text Search à partir d'un ensemble de coordonnées de latitude/longitude.
- Renvoyer la distance, le temps de trajet et l'URI de l'itinéraire vers des lieux à proximité à partir d'un ensemble de coordonnées de latitude/longitude.
- Renvoie la distance, le temps de trajet et l'URI de l'itinéraire entre le point de départ d'un itinéraire prédéfini et chacun des lieux renvoyés en fonction d'une chaîne de requête, qui se trouvent également le long de l'itinéraire.
- Renvoyer la distance, le temps de trajet et l'URI de l'itinéraire entre chacun des lieux renvoyés en fonction d'une chaîne de requête, qui se trouvent également sur un itinéraire prédéfini, et la destination de l'itinéraire.