Retour aux API
Données indépendantes de Google Maps

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éeComportement à l’exécutionQuand l’utiliser
location seulLe texte de location est combiné à query pour la découverteRecherches fondées sur une ville, un quartier, un point de repère ou une adresse
location plus les deux coordonnéeslocation reste obligatoire et les coordonnées sont transmises sous les noms lat et longUn centre géographique vérifié est disponible
location plus une seule coordonnéeLa coordonnée fournie est transmise indépendammentÀ n’utiliser que si le contexte géographique partiel est voulu
country et zoom_levelLe contexte facultatif est transmis avec la ligne de rechercheLa 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. 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. 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. 3. Lire les lieux normalisés

    Traitez data.results.items et suivez next_cursor tant que has_more vaut true.

Rechercher des lieux publics

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 true

Cas 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.

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.