google-maps/
place-details

Collectez les détails d’URL Google Maps publiques connues, avec des champs normalisés : identité du lieu, catégorie, adresse, contact, note, nombre d’avis, site web et données géographiques.

Google Maps Place Details API

URL Maps connues
Détails de lieux
Localisations normalisées
0,15 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Google Maps Place Details

Les pages publiques de lieux Google Maps peuvent exposer noms, catégories, descriptions, adresses, coordonnées de contact, notes, nombres d’avis, sites web et contexte géographique. Des enregistrements normalisés facilitent le rapprochement de ces champs visibles avec des inventaires de sites, des études de lieux, l’enrichissement d’annuaires et un suivi à un instant donné.

Fonctionnalités de la Google Maps Place Details API

  • Collecte de détails par lot d’URLEnvoyez une ou plusieurs URL Google Maps connues : chaque entrée non vide devient une ligne de détail côté fournisseur, plafonnée en interne au nombre d’URL envoyées.
  • Fiches de lieu stablesRenvoie l’identité, l’URL source, le nom, la description, la catégorie, l’adresse, le téléphone, le site web, la note et le nombre d’avis via le schéma PlaceItem.
  • Contexte géographique structuréConserve ensemble le nom du lieu, la ville, la région, le pays, la latitude et la longitude lorsqu’ils sont disponibles, sans avoir à les extraire d’un texte de présentation.
  • Facturation au résultatEstimation à 0,15 crédit par URL envoyée, puis règlement à 0,15 crédit pour chaque fiche de lieu standard renvoyée avec succès ; aucun frais en cas de résultat vide.

Paramètres de la Google Maps Place Details API

ParamètresObligatoireDescription
urlsObligatoireTableau obligatoire et non vide de références dont l’analyseur extrait un nom d’hôte. L’exécution accepte google.com, goo.gl et leurs sous-domaines selon le nom d’hôte ; elle accepte tout schéma comportant une composante d’autorité ainsi que les références relatives au protocole, et n’impose aucun modèle de chemin particulier.

Comment utiliser la Google Maps Place Details API

Envoyez des URL Google Maps connues, suivez la tâche asynchrone et lisez chaque PlaceItem enregistré via l’enveloppe de résultats standard à curseur.

  1. Préparez une ou plusieurs références dont le nom d’hôte analysé est google.com, goo.gl ou un sous-domaine de l’un de ces deux hôtes acceptés.
  2. Envoyez urls en POST à /v1/google-maps/place-details et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items et suivez next_cursor tant que has_more vaut true ; la requête d’envoi n’a elle-même aucun champ results_limit.
curl -X POST "https://api.socq.ai/v1/google-maps/place-details" \
  -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"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Google Maps Place Details API

  • Enrichissement d’annuaires de lieux : Ajoutez aux URL de lieux connues les champs normalisés de catégorie, d’adresse, de téléphone, de site web, de note, de nombre d’avis et de coordonnées.
  • Audits de sites et d’agences : Repassez sur une liste d’URL maîtrisée pour comparer l’identité, les coordonnées de contact, la note et les valeurs géographiques visibles à des dates de collecte définies.
  • Rapprochement de fiches de lieu : Utilisez les ID, URL sources, noms, adresses et coordonnées renvoyés pour associer des lieux publics à vos fiches de localisation internes.

Conseils d’expert pour la Google Maps Place Details API

  • Envoyez des URL Maps absolues et complètes pour que l’analyseur retrouve un nom d’hôte accepté ; un nom d’hôte seul, sans schéma, ne donne aucun nom d’hôte dans l’analyseur de l’exécution.
  • N’ajoutez ni Place ID, ni clé API Google, ni masque de champs, ni results_limit : ce ne sont pas des champs de cette spécification de requête SocQ.
  • Considérez chaque URL envoyée comme un candidat à un détail, et non comme un résultat garanti ; une source indisponible ou inexploitable peut laisser moins d’éléments que d’URL.
  • Laissez nuls le téléphone, le site web, la note, le nombre d’avis, la description, l’heure de publication et les éléments de localisation lorsqu’ils manquent, plutôt que d’inventer des valeurs de repli.
  • Poursuivez avec next_cursor tant que has_more vaut true : la pagination s’applique à la lecture des résultats enregistrés, même si le plafond côté fournisseur découle du nombre d’URL.

En complément de la Google Maps Place Details API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Maps.

Explorer d’autres plateformes

Combinez les données Google Maps avec les données publiques d’autres plateformes sociales prises en charge.

Google Maps Place Details API — FAQ

Google Maps Place Details API transforme des URL Google Maps publiques connues en enregistrements PlaceItem normalisés. Elle renvoie les champs disponibles d’identité, de catégorie, de contact, de note, de nombre d’avis, d’adresse, de site web et de localisation.

Envoyez des références dont le nom d’hôte analysé est google.com, goo.gl ou un sous-domaine de l’un de ces hôtes. Tout schéma est accepté dès lors qu’une autorité et un nom d’hôte sont présents ; les références relatives au protocole sont également acceptées, et aucun chemin /maps/place précis n’est requis.

Non. La requête accepte des URL Google Maps publiques connues via SocQ et n’accepte ni Place ID officiel, ni clé API Google, ni identifiant OAuth, ni masque de champs.

Non. L’entrée côté fournisseur contient une ligne de détail par URL non vide et un plafond interne égal à ce nombre de lignes ; results_limit n’est pas un champ de requête public.

Une URL source peut être indisponible, renvoyer une ligne d’erreur ou ne pas aboutir à un lieu normalisé exploitable. Les autres URL envoyées sont traitées indépendamment.

Interrogez GET /v1/tasks/{task_id}, lisez data.results.items après le succès, puis demandez la page suivante avec next_cursor tant que has_more vaut true.

L’estimation est de 0,15 crédit SocQ par URL non vide envoyée. La facturation finale est de 0,15 crédit par fiche de lieu standard renvoyée avec succès, et un jeu de résultats vide coûte zéro crédit.