Aide-mémoire de l'API Places (ancienne version)

L'API Places (ancienne version) ne pourra plus être activée pour les nouveaux projets Google Cloud à partir d'octobre 2026. Les projets existants restent entièrement pris en charge. Pour bénéficier de nouvelles fonctionnalités et de meilleures performances, migrez vers l'API Places (New).

API Places (ancienne version) : informations clés

  • Produit : API Places (ancienne version)
  • Également appelée : API Places (ancien service Web), service Web de l'API Places (maps/api/place)
  • Catégorie : Lieux
  • Plate-forme : service Web (REST)
  • S'exécute sur : le serveur (code backend)
  • Étape de lancement : GA
  • Cycle de vie : Ancien
  • Remplacée par : API Places (nouvelle version)
  • Présentation : Présentation de l'API Places (ancienne version)

API Places (ancienne version) : quand l'utiliser

Utilisez l'API Places (ancienne version) dans les cas suivants :

  • Vous gérez un projet existant pour lequel l'API Places (ancienne version) est déjà activée et qui appelle des points de terminaison maps.googleapis.com/maps/api/place.
  • Vous devez disposer d'appels Find Place, Nearby Search, Text Search, Details, Photos ou Autocomplete (ancienne version) existants pour continuer à travailler pendant la migration.

N'utilisez pas l'API Places (ancienne version) dans les cas suivants :

  • Vous démarrez un nouveau projet Google Cloud. À partir d'octobre 2026, l'API Places (ancienne version) ne pourra plus être activée pour les nouveaux projets. Utilisez plutôt l'API Places (nouvelle version).
  • Vous avez besoin de nouvelles fonctionnalités, de l'authentification OAuth ou de masques de champ sur Nearby Search et Text Search pour ne payer que pour les champs que vous demandez. Utilisez plutôt l'API Places (nouvelle version).
  • Vous avez besoin de Find Place (ancienne version) ou de Query Autocomplete (ancienne version) dans le nouveau code. Text Search (New) et Autocomplete (New) les remplacent. Utilisez plutôt l'API Places (nouvelle version).

API Places (ancienne version) : configuration

API Places (ancienne version) : erreurs courantes

  • Problème : Si une requête Place Details (ancienne version) omet le paramètre fields ou ne spécifie aucun champ, l'API renvoie tous les champs et vous les facture tous. Correction : définissez toujours le paramètre fields ou migrez vers Place Details (New) avec un masque de champ. Consultez /maps/documentation/places/web-service/legacy/details.
  • Problème : Nearby Search (ancienne version) et Text Search (ancienne version) ne permettent pas de spécifier les champs à renvoyer. Elles renvoient toujours un ensemble fixe de champs (un sous-ensemble de champs Place Details) et déclenchent les SKU Basic Data, Contact Data et Atmosphere Data. Correction : Migrez vers Nearby Search (New) ou Text Search (New) avec un masque de champ, ou utilisez Find Place (Legacy) avec le paramètre fields pour demander et payer uniquement les champs dont vous avez besoin. Consultez /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku.
  • Problème : un photo_reference ne peut pas être mis en cache et peut expirer. Les références stockées cessent donc de fonctionner. Correction : Obtenez un nouveau photo_reference à partir d'une réponse Place Details, Find Place, Nearby Search ou Text Search avant de demander une photo. Consultez /maps/documentation/places/web-service/legacy/photos.
  • Problème : Les appels à l'API Places (ancienne version) depuis un projet où elle n'est pas activée renvoient REQUEST_DENIED avec le message d'erreur "Vous appelez une ancienne API qui n'est pas activée pour votre projet…" (LegacyApiNotActivatedMapError). À partir d'octobre 2026, l'API Places (ancienne version) ne pourra plus être activée pour les nouveaux projets. Correction : Utilisez l'API Places (New) pour les nouveaux projets et migrez les applications existantes. Pendant la migration, vous pouvez demander l'activation à court terme de l'ancienne API via le formulaire de commentaires sur l'ancienne page. Consultez /maps/legacy#LegacyApiNotActivatedMapError.

API Places (ancienne version) : anciennes fonctionnalités et fonctionnalités obsolètes

  • Champ de réponse permanently_closed : obsolète depuis le 26/05/2020. Remplacement : champ business_status. Consultez le guide de migration.
  • Champ de réponse reference : obsolète depuis le 03/09/2019. Remplacement : champ place_id. Consultez le guide de migration.
  • Paramètre de requête Nearby Search (ancienne version) name : obsolète. Remplacement : paramètre keyword. Consultez le guide de migration.