Google a lancé Places API (New) en 2023 pour remplacer progressivement l'API legacy. En 2026, l'ancienne API est dépréciée et la nouvelle est devenue le standard. Voici les principales différences à connaître si vous construisez un produit qui utilise Google Maps.
Pricing par SKU, pas par requête
L'ancienne API facturait au nombre de requêtes. La nouvelle facture au « SKU » : Essentials, Pro, Enterprise, Enterprise Atmosphere. Chaque requête est billable au tier du champ le plus premium demandé. Conséquence : un field mask mal construit peut multiplier votre facture par 4.
Field mask obligatoire
Toutes les requêtes doivent spécifier un header X-Goog-FieldMask qui liste explicitement les champs retournés. Omettre ce header = 400. C'est une sécurité Google pour éviter les factures exorbitantes par inattention.
Limites de pagination
searchText retourne jusqu'à 20 résultats par requête (contre 60 avant). La pagination existe via nextPageToken mais le token met parfois quelques secondes à devenir valide. Pour des listes exhaustives, il faut paginer sur 3 pages successives avec un petit délai entre.
Rétention de données : 30 jours
Les CGU de Google Maps Platform imposent de ne pas conserver les données Places plus de 30 jours côté serveur, à l'exception du place_id qui peut être conservé indéfiniment. C'est un piège pour les produits qui veulent construire une base de données propriétaire — c'est strictement interdit.
rankPreference: DISTANCE
Par défaut searchText classe par pertinence (donc popularité). Pour surfer les résultats moins connus — idéal pour la prospection locale — il faut passer rankPreference: "DISTANCE". C'est l'un des paramètres les plus utiles et les moins documentés.