Les API Fiche d'établissement 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 Fiche d'établissement, vous devez enregistrer votre application et obtenir des identifiants OAuth 2.0. Pour savoir comment vous lancer avec les API Business Profile, consultez Configuration de base.
Utiliser les données d'adresse
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 Fiche d'établissement et l'API Maps.
Ressources couramment utilisées concernant les fiches d'établissement
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'une entreprise.
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 Google Maps suivantes sont également utiles:
- L'API renvoie des prédictions de lieu à l'aide de Place Autocomplete et de Place Details. Pour en savoir plus sur les tarifs, consultez la page SKU: Autocomplete (avec Places Details) – Per Session.
- L'API permet de rechercher des informations sur un lieu à l'aide de Place Search. Pour en savoir plus sur les tarifs, consultez la page SKU: Find Place.
- Fournir le geocoding et le geocoding inversé des adresses avec Geocoding Pour en savoir plus sur les tarifs, consultez la page SKU: Geocoding.
Une ou zéro correspondance
Lorsqu'un partenaire recherche des fiches qui correspondent à un établissement, son objectif est de réduire les résultats de recherche à une ou zéro correspondance. Autrement dit, soit l'établissement correspond à ses critères de recherche, soit il n'a pas encore de fiche d'établissement.
Lorsqu'il y a une ou zéro 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 parvient pas à géocoder l'adresse, la création de l'établissement échoue, et la réponse de l'API inclut une requête de données LatLng. Pour savoir comment le marchand peut fournir ses données LatLng, consultez Ajustement manuel des données de géolocalisation.
La fiche est créée une fois les coordonnées LatLng 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 ou zéro correspondance, les correspondances partielles et multiples sont résolues manuellement selon deux cas d'utilisation de l'API Google Maps.
L'utilisateur affine sa recherche
Lorsqu'un utilisateur de la plate-forme partenaire recherche un établissement et rencontre plusieurs correspondances partielles, il peut résoudre le problème de l'une des manières suivantes:
- En analysant les adresses qui correspondent partiellement et en sélectionnant la bonne adresse
- Modifiez ou saisissez à nouveau certaines parties de l'adresse pour plus de précision, et réduisez les résultats à une ou zéro correspondance.
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, un utilisateur peut saisir l'adresse suivante sur une plate-forme partenaire:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Supposons que les réponses suivantes soient renvoyées, et qu'elles correspondent toutes à 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. Pour fournir aux consommateurs un itinéraire précis, il peut être nécessaire d'ajuster les données de latitude et de longitude (LatLng) de ces établissements. Pour savoir comment les utilisateurs peuvent saisir leurs coordonnées LatLng manuellement, consultez Ajustement manuel des données de géolocalisation.
Ajustement manuel des 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. Les nouveaux établissements peuvent ne pas connaître leurs coordonnées LatLng. Ils peuvent donc placer manuellement un repère avec le widget JavaScript Places de Maps afin d'établir des coordonnées LatLng précises.
LatLng, il est nécessaire d'ajuster manuellement celles-ci pour chaque établissement.Qualité des résultats de recherche
Les résultats de recherche varient considérablement selon la précision de l'adresse recherchée et la zone géographique. Les régions en voie de développement affichent souvent moins de lieux dans Maps et ne respectent pas toujours les formats d'adresse de Google. Les résultats de recherche sont donc de moins bonne qualité, et il est plus nécessaire de mettre en forme manuellement les adresses et d'utiliser l'API Google Maps.