Mettez à jour votre intégration de l'API Google Business Profile avant la désactivation des points de terminaison critiques. Consultez le planning d'abandon et les instructions pour éviter toute perturbation à partir d'avril 2022.

Rechercher des fiches correspondantes

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Les API Business Profile vous permettent de créer une plate-forme permettant à vos marchands de gérer leur activité sur Google. Sur votre plate-forme, vous pouvez autoriser vos partenaires à rechercher des fiches correspondant au nom, à l'adresse et aux données téléphoniques de leur entreprise. Ils peuvent revendiquer la propriété d'un établissement, et définir avec précision sa position géographique à l'aide de sa latitude et de sa longitude.

Avant de commencer

Avant d'utiliser les API Business Profile, vous devez enregistrer votre application et obtenir des identifiants OAuth 2.0. Pour savoir comment utiliser les API Business Profile, consultez Configuration de base.

Utiliser les données d'adresses

Pour exploiter les données d'adresses et de géolocalisation sur votre plate-forme, vous pouvez utiliser deux ensembles d'API et de ressources : les API Business Profile et les API Maps.

Ressources concernant les fiches d'établissement couramment utilisées

L'API GoogleLocations permet au marchand de voir à l'avance si un établissement a déjà été revendiqué dans une fiche d'établissement. Si ce n'est pas le cas, le marchand peut alors en demander l'accès immédiatement.

L'objet PostalAddress représente l'adresse physique d'un établissement.

Ressources Google Maps couramment utilisées

Les widgets JavaScript Places de Maps sont couramment utilisés dans les flux de travail des partenaires pour créer une carte interactive. Les API Maps suivantes sont également utiles :

Une seule correspondance ou aucune

Lorsqu'un partenaire recherche des fiches qui correspondent à un établissement, son objectif est de réduire les résultats de recherche à une correspondance ou zéro. C'est-à-dire que soit l'établissement correspond à ses critères de recherche soit il n'a pas encore de fiche d'établissement.

Lorsqu'il n'y a qu'une seule correspondance ou aucune correspondance, utilisez la méthode accounts.locations.create pour créer une fiche ou suivez le guide GoogleLocations pour revendiquer la propriété de la fiche existante. Si Google ne peut pas géocoder l'adresse, la création de l'établissement échoue, et la réponse de l'API inclut une requête pour des données LatLng. Pour en savoir plus sur la manière dont le marchand peut fournir ses données LatLng, consultez la section Ajustement manuel des données de géolocalisation.

La fiche est créée une fois que les coordonnées LatLng ont été déterminées.

Correspondances partielles et multiples

Lorsque le propriétaire d'un établissement ou l'équipe partenaire chargée des opérations recherche des fiches correspondant à un établissement, les informations saisies peuvent générer plusieurs correspondances ou ne générer qu'une correspondance partielle. Pour limiter les résultats de recherche à une seule correspondance (ou à aucune), les deux cas d'utilisation suivants de l'API Maps permettent de résoudre manuellement les correspondances partielles et multiples.

Lorsqu'un utilisateur de la plate-forme partenaire recherche un établissement et obtient plusieurs correspondances partielles, il peut résoudre le problème de l'une des manières suivantes :

  • En analysant les adresses correspondantes partielles et en sélectionnant la bonne adresse
  • En modifiant et en saisissant de nouveau certaines parties de l'adresse pour plus de précision, puis en réduisant les résultats à une ou aucune correspondance
Un utilisateur obtient plusieurs correspondances partielles en réponse à sa recherche d'adresse.

L'utilisateur sélectionne une ou plusieurs correspondances complètes

Dans certains cas, plusieurs établissements peuvent correspondre exactement à l'adresse recherchée par l'utilisateur. Par exemple, imaginons qu'un utilisateur saisit l'adresse suivante sur une plate-forme partenaire :

Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia

Supposons à présent que les réponses suivantes sont renvoyées, et que chacune correspond à l'adresse en question :

  • Kasperson Printer Center, un établissement non validé
  • Bengo SEGURO, un établissement validé
  • Garush Productions, un établissement non validé

L'utilisateur doit sélectionner manuellement l'établissement correspondant. Afin de fournir aux consommateurs un itinéraire précis vers l'établissement, il peut être nécessaire d'ajuster les données de latitude et de longitude (LatLng) de ces établissements afin d'optimiser la précision des résultats. Pour savoir comment les utilisateurs peuvent saisir leurs coordonnées LatLng manuellement, consultez la section Ajuster manuellement les données de géolocalisation.

Ajuster manuellement les données de géolocalisation

Les établissements peuvent ajouter leurs coordonnées de latitude et de longitude (LatLng) afin d'améliorer la précision de leur fiche. Lorsqu'un nouvel établissement ne connaît pas ses coordonnées LatLng, il peut déposer manuellement un repère avec le widget JavaScript Places de Maps afin d'établir des coordonnées LatLng précises.

Une même adresse permet d'obtenir comme résultats trois établissements situés à moins de 500 mètres les uns des autres. Pour associer précisément l'adresse de l'établissement à ses coordonnées LatLng, vous devez ajuster manuellement celles-ci pour chaque établissement.

Qualité des résultats de recherche

Les résultats de recherche varient considérablement selon l'exactitude de l'adresse recherchée et de la zone géographique. Les zones en voie de développement affichent souvent moins de lieux dans Maps et ne respectent pas toujours les formats d'adresse de Google. La qualité des résultats est alors réduite, ce qui entraîne la nécessité de mettre en forme manuellement les adresses et d'utiliser l'API Maps.