Google Maps Reviews
Les avis Google Maps sont des retours publics sur un lieu, pouvant comporter un texte rédigé, une référence de l’auteur, une note, des liens vers la source et le sujet, les dates de publication et de collecte, ainsi que des médias. Ils servent à constituer des jeux de retours reliés à leur source et à comparer des lieux connus ou des fenêtres de collecte.
Fonctionnalités de la Google Maps Reviews API
- Lot d’URL connuesEnvoyez une ou plusieurs URL google.com ou goo.gl prises en charge dans une seule tâche asynchrone, au lieu de résoudre les lieux avec une API d’identifiants distincte.
- Fenêtre en jours facultativeAppliquez une valeur days_limit positive unique à chaque ligne d’URL envoyée lorsque votre workflow a besoin d’une fenêtre d’avis récents.
- Avis structurés et stablesLisez l’identité de l’avis, le texte, les champs de l’auteur, la note, les références du lieu, les horodatages, l’URL source et les médias disponibles via le schéma d’avis v1.0.
Paramètres de la Google Maps Reviews API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une ou plusieurs URL non vides sur google.com, sur n’importe quel sous-domaine de google.com, sur goo.gl ou sur un sous-domaine de goo.gl, séparées par des virgules ou des retours à la ligne. Utilisez des URL de lieux Maps connues pour collecter des avis. |
days_limit | Facultatif | Entier positif facultatif appliqué à chaque ligne d’entrée du fournisseur comme fenêtre de récence des avis. Omettez-le pour n’envoyer aucun filtre de fenêtre en jours. |
results_limit | Facultatif | Entier facultatif de 1 à 2 000 qui plafonne le nombre total d’avis enregistrés pour la tâche. La valeur par défaut est 100, et la disponibilité de la source peut produire moins de lignes. |
Comment utiliser la Google Maps Reviews API
Envoyez des URL Google Maps connues, suivez la tâche asynchrone et lisez les avis enregistrés grâce au curseur de résultats de la tâche.
- Préparez une ou plusieurs URL de lieux Google Maps prises en charge, sur google.com ou goo.gl.
- Envoyez urls et, si nécessaire, days_limit et results_limit en POST à /v1/google-maps/reviews.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez /v1/tasks/{task_id}?limit=50 et continuez avec results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Cas d’usage de la Google Maps Reviews API
- Jeux de retours sur des lieux connus : Préparez le texte des avis, les notes, les dates de publication et les liens sources pour un ensemble défini d’URL de lieux publics.
- Étude des auteurs d’avis, source à l’appui : Conservez les noms, pseudonymes, liens de profil et URL d’avis des auteurs lorsqu’ils sont disponibles, afin que les enregistrements restent traçables jusqu’à leur contexte public.
- Comparaisons sur fenêtres récentes : Relancez le même ensemble de lieux avec des valeurs days_limit documentées à différents moments pour comparer des collectes bornées, sans prétendre à un historique complet.
- Archives d’avis avec médias : Gardez les médias d’avis disponibles à côté du texte, de la note, de la référence du lieu et de la date de collecte dans un enregistrement de recherche normalisé.
Conseils d’expert pour la Google Maps Reviews API
- Envoyez des URL Maps google.com ou goo.gl résolvables ; un nom de lieu, un compte Google Business Profile ou un Place ID seul n’est pas un élément urls accepté.
- N’utilisez days_limit que si une fenêtre exprimée en nombre entier positif a un sens ; l’omettre laisse la ligne du fournisseur sans ce filtre.
- Traitez results_limit comme un plafond global de résultats enregistrés pour tout le lot d’URL, et non comme une promesse par URL.
- Séparez le results_limit de l’envoi du limit de lecture de la tâche : ce dernier règle la taille de page, de 1 à 500, et s’appuie sur un curseur opaque.
- Admettez que le texte, les attributs de l’auteur, la note, les références du sujet, les horodatages et les médias puissent être absents lorsque la source publique ne les expose pas.
API associées
En complément de la Google Maps Reviews API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Maps.
- Google Maps Search API — Recherchez des lieux publics sur Google Maps par requête et localisation avec identité, adresse, contact, note, nombre d’avis, URL et coordonnées normalisés.
- Google Maps Place Details API