Google Maps API
Découvrez des lieux publics, récupérez des détails normalisés à partir d’URL Maps connues et collectez des avis publics avec le contexte du lieu et de l’auteur relié à la source.
API Google Maps disponibles
Utilisez Search pour la découverte par requête et lieu, Place Details pour des URL Maps connues, et Reviews pour la collecte bornée d’avis publics.
Quelles données Google Maps pouvez-vous récupérer ?
SocQ renvoie des enregistrements PlaceItem publics normalisés pour l’étude de localisation, la découverte d’entreprises, l’enrichissement de données et les instantanés de marché à un instant donné.
Identité du lieu
Récupérez les ID de lieu, noms, catégories, URL sources, types d’enregistrement et horodatages de collecte disponibles.
Adresses et contexte géographique
Conservez les adresses formatées, libellés de lieu, villes, régions, pays, latitude et longitude disponibles.
Coordonnées publiques
Collectez les numéros de téléphone et sites web publics lorsqu’un résultat de recherche les expose.
Notes et nombres d’avis
Gardez la note et le nombre d’avis communiqués par la source lorsqu’ils sont disponibles, sans déduire les valeurs manquantes.
Descriptions et catégories
Exploitez le texte de résumé et les libellés de catégorie disponibles pour classer et présélectionner les lieux.
Métadonnées de tâche et de pagination
Suivez le statut de la tâche et result_count, puis parcourez les enregistrements PlaceItem stockés avec next_cursor et has_more.
Texte du lieu et contexte de coordonnées
Google Maps Search exige toujours query et location. Dans la spécification d’exécution actuelle, les coordonnées sont un contexte facultatif et ne remplacent pas location.
| Choix d’entrée | Comportement à l’exécution | Quand l’utiliser |
|---|---|---|
| location seul | Le texte de location est combiné à query pour la découverte | Recherches fondées sur une ville, un quartier, un point de repère ou une adresse |
| location plus les deux coordonnées | location reste obligatoire et les coordonnées sont transmises sous les noms lat et long | Un centre géographique vérifié est disponible |
| location plus une seule coordonnée | La coordonnée fournie est transmise indépendamment | À n’utiliser que si le contexte géographique partiel est voulu |
| country et zoom_level | Le contexte facultatif est transmis avec la ligne de recherche | La requête a besoin d’une indication de pays ou d’un zoom explicite de 0 à 21 |
Fonctionnement de l’API Google Maps
Envoyez une recherche de lieux bornée, attendez la collecte asynchrone, puis parcourez les enregistrements normalisés stockés pour la tâche.
1. Définir la recherche de lieux
Choisissez une query précise et le location obligatoire, puis n’ajoutez que le contexte géographique facultatif vérifié dont vous avez besoin.
2. Envoyer et suivre la tâche
Envoyez la requête en POST, conservez task_id et interrogez /v1/tasks/{task_id} jusqu’à la réussite ou l’échec du traitement.
3. Lire les lieux normalisés
Traitez data.results.items et suivez next_cursor tant que has_more vaut true.
Envoyez une query et un location avec un petit plafond de résultats, puis lisez les résultats PlaceItem normalisés depuis l’endpoint de tâche commun.
curl -X POST "https://api.socq.ai/v1/google-maps/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"coffee","location":"New York, NY","country":"US","results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage courants de l’API Google Maps
Découverte d’entreprises locales
Trouvez des entreprises publiques correspondant à une catégorie ou un service dans une ville, un quartier, un point de repère ou une adresse.
Enrichissement de données de lieux
Ajoutez les champs de contact, d’adresse, de catégorie, de note, de nombre d’avis, d’URL et de coordonnées disponibles à des lieux candidats existants.
Instantanés de marchés géographiques
Collectez des jeux de résultats bornés pour des zones envoyées séparément et comparez la couverture publique des lieux à des moments de collecte précis.
Files de vérification
Constituez une présélection à partir des champs publics d’identité, de contact, de note et de géographie pour une revue ultérieure ou un processus de détail distinct.
Limites et politique sur les données publiques
Les résultats sont des enregistrements publics pris à un instant donné. La disponibilité de la recherche et la complétude des champs dépendent de ce que la source expose pour la requête envoyée.
- query et location sont toutes deux des chaînes obligatoires et non vides ; location ne peut pas être remplacé par des coordonnées.
- country, latitude, longitude et zoom_level sont facultatifs ; l’exécution actuelle accepte latitude et longitude indépendamment.
- zoom_level doit être un entier de 0 à 21, et results_limit vaut 100 par défaut avec une plage acceptée de 1 à 2 000.
- results_limit est un maximum de collecte, tandis que le paramètre limit du GET de tâche contrôle chaque page de réponse des résultats stockés.
- Les résultats publics peuvent omettre descriptions, catégories, coordonnées de contact, notes, nombres d’avis, URL ou sous-champs géographiques.
- Les identités exposées en double ne sont stockées qu’une fois par tâche ; result_count peut donc être inférieur au nombre de lignes sources observées.
Questions fréquentes sur l’API Google Maps
Qu’est-ce que l’API Google Maps ?
Les API Google Maps recherchent de façon asynchrone des lieux publics, résolvent des URL de lieux connues et collectent des avis publics sous forme d’enregistrements normalisés. Search accepte query et location et renvoie des enregistrements PlaceItem avec les champs disponibles d’identité, d’adresse, de contact, de note, de nombre d’avis, d’URL et de coordonnées.
Que requiert Search ?
Search exige des chaînes query et location non vides ; les paramètres country, latitude, longitude, zoom_level et results_limit sont facultatifs.
Quelle différence entre pagination de collecte et pagination de réponse ?
results_limit borne les enregistrements collectés pour la recherche envoyée. Après la réussite, l’endpoint de tâche renvoie les enregistrements stockés par pages, selon ses propres paramètres limit et next_cursor.
Pourquoi des champs de lieu peuvent-ils valoir null ?
Un résultat de recherche public peut ne pas exposer chaque champ de contact, de note, d’avis, de description, d’URL, d’adresse ou de coordonnées. Le schéma normalisé conserve ces valeurs manquantes sous forme de null.
Comment les résultats de Google Maps Search sont-ils tarifés ?
Chaque lieu stocké coûte 0,15 crédit. L’estimation préfacturée utilise results_limit, ou 100 s’il est omis, et la clôture se fait sur le nombre réel de résultats stockés.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.
Google Play API
Rassemblez les détails d’applications, les classements par catégorie et les avis publics de Google Play via des URL connues de la boutique, sous forme d’enregistrements d’applications et d’avis normalisés.
Amazon API
Recherchez des produits Amazon publics et collectez des détails de produits, Best Sellers, avis, profils de vendeurs et vitrines de créateurs normalisés sur les places de marché prises en charge.
Apple App Store API
Collectez les détails d’applications, les classements par catégorie et les avis publics de l’Apple App Store à partir d’URL connues de la boutique, sous forme d’enregistrements d’applications et d’avis normalisés.
SEO API
Interrogez en direct les résultats organiques de Google, comparez la demande et la difficulté de classement des mots-clés, développez des termes de départ, repérez les mots-clés et les pages qui assurent la visibilité d’un site dans la recherche, classez l’intention de recherche et collectez les résultats de Google News, Google Images, Google Autocomplete, Bing et YouTube. Chaque endpoint utilise la même clé API SocQ, le même flux de tâche asynchrone et le même format de résultat normalisé.
Telegram API
Lisez les chaînes Telegram publiques à partir de leurs liens t.me : profils de chaîne avec nombre d’abonnés, publications avec vues et réactions, publications isolées, commentaires des groupes de discussion, chaînes similaires et recherche dans tout l’historique.
Link in Bio API
Transformez l’unique lien de la bio Instagram, TikTok ou YouTube d’un créateur en données structurées : nom affiché, bio, avatar, e-mail de contact indiqué, profils sociaux liés et chaque bouton de la page avec son titre et sa destination.


