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 utiliser les API Fiche d'établissement, 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 Fiche d'établissement et les 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'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 :
- 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.
- L'API permet de fournir le geocoding et le geocoding inversé des adresses à l'aide du service 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. 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 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 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. En cas de correspondances partielles ou multiples, l'API Maps permet de réduire manuellement le nombre de résultats de recherche à zéro ou une correspondance, et ce de deux façons :
L'utilisateur affine sa recherche
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 qui correspondent partiellement et en sélectionnant la bonne adresse
- En modifiant et en saisissant de nouveau certaines parties de l'adresse pour être plus précis, puis en réduisant 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, 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, il peut être nécessaire d'optimiser la précision des résultats en ajustant les données de latitude et de longitude (LatLng) de l'établissement. Pour savoir comment les utilisateurs peuvent saisir leurs coordonnées LatLng manuellement, consultez la section 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. 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.
LatLng, il faut 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 zones 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 davantage nécessaire de mettre en forme manuellement les adresses et d'utiliser l'API Maps.