Important : La version 4.7 de l'API a été publiée. Consultez le journal des modifications. Les chaînes d'établissements sont toujours autorisées temporairement à créer des posts en rapport avec le COVID-19.

Rechercher des fiches correspondantes

Avec l'API Google My Business, vous pouvez 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 établir la propriété d'un établissement, et définir avec précision la position géographique de l'établissement en fonction de sa latitude et de sa longitude.

Avant de commencer

Avant d'utiliser l'API Google My Business, vous devez enregistrer votre application et obtenir des identifiants OAuth 2.0. Pour en savoir plus sur la manière de vous lancer avec l'API Google My Business, consultez la section 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 : l'API Google My Business et l'API Maps.

Ressources Google My Business couramment utilisées

L'API GoogleLocations permet au marchand de voir à l'avance si un établissement a déjà été revendiqué dans Google My Business. 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 correspondantes pour un établissement, son objectif est de limiter les résultats de recherche à pas plus d'une correspondance. En effet, un tel résultat signifie que l'établissement correspond à ses critères de recherche ou n'existe pas encore dans Google My Business.

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 être mis en correspondance exacte avec l'adresse recherchée par l'utilisateur. Par exemple, imaginons qu'un utilisateur saisisse 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 soient renvoyées, et que chacune corresponde à 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 les coordonnées de latitude et de longitude (LatLng) de leur établissement afin d'améliorer la précision de leur fiche sur Google My Business. 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 d'un mètre l'un de l'autre. 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.