Lieu et point d'intérêt

Le flux de produits vous permet de spécifier de différentes manières les points d'intérêt associés au produit. Google utilise ces informations pour présenter le produit aux utilisateurs lorsqu'ils recherchent des POI ou des destinations pertinents.

Chaque option de produit peut spécifier un ou plusieurs points d'intérêt (POI) associés à l'option à l'aide du champ related_location (qui contient une liste d'objets RelatedLocation). Chaque objet RelatedLocation contient un champ location décrivant le POI en question et un champ relation_type décrivant la relation entre le POI et l'option de produit.

Une option de produit ne doit être marquée comme associée que si elle offre une expérience pertinente en lien avec le lieu en plus de la visite physique. La définition de "pertinente" peut varier selon les lieux, mais généralement, les éléments qui ne doivent pas être marqués comme associés incluent les points de vue d'un POI (par exemple lors d'une visite en bus ou en bateau) ou les points de rendez-vous d'une visite guidée (utilisez à la place le champ meeting_point). Les trois relation_types sont les suivants :

  • RELATED_NO_ADMISSION : le lieu est associé, mais l'option de produit n'inclut pas l'entrée ou l'entrée n'est pas pertinente. Par exemple, si le lieu est une place mise en avant dans une visite de la ville.

  • ADMISSION_TICKET : la relation permet d'accéder à ce lieu associé.

  • SUPPLEMENTARY_ADDON : la relation déclare un service supplémentaire qui ne permet pas à l'utilisateur d'accéder au lieu associé. Par exemple, un ticket de parking ou une exposition temporaire.

Exemples

relation_type Exemple
RELATED_NO_ADMISSION Visite à pied autour de la tour Eiffel sans entrée. Visite en hélicoptère autour du Burj Khalifa.
ADMISSION_TICKET Billet d'entrée pour un zoo, peut inclure des modules complémentaires.
SUPPLEMENTARY_ADDON Coupe-file sans entrée, audioguide sans entrée.
Non associé Croisière en bateau qui permet de voir le POI de loin. Agence de voyages où la visite commence ou où les billets peuvent être achetés.

Chaque option de produit peut également avoir un meeting_point pour certains types de visites dont le point de départ n'est pas clair et doit être déterminé (par exemple, les visites guidées).

Demander l'ajout d'une nouvelle attraction

Si vous fournissez les billets officiels pour des attractions et que vous remarquez qu'une des attractions avec lesquelles vous travaillez n'est pas disponible dans Activités à découvrir de Google, vous pouvez remplir le formulaire de demande de nouveau POI pour demander à ce que le POI soit ajouté à Activités à découvrir.

Lors du traitement d'un flux entrant, Google tente de faire correspondre les indications de lieu fournies sous forme de chaînes de texte à des entités internes à Google représentant ces lieux, appelées points d'intérêt (POI).

Un POI peut être défini de manière générale comme un repère nommé sur un lieu spécifique (coordonnées). Dans le contexte d'Activités à découvrir, les exemples pertinents incluent les voyagistes et les attractions touristiques. Toutefois, de manière générale, un POI peut être n'importe quel établissement dont le nom et l'emplacement sont connus de Google.

La correspondance des lieux fait référence au processus de mise en correspondance d'un lieu associé, sous la forme d'une indication textuelle, avec un POI connu de Google, s'il existe dans la base de données Google.

Il existe plusieurs façons d'envoyer un lieu associé à Google, en fonction de la source des données de lieu, des exigences contractuelles avec les fournisseurs et du niveau de contrôle que vous souhaitez exercer sur le processus de mise en correspondance.

Les types d'indications suivants sont acceptés (par ordre de préférence) :

Types d'indications

Type Description Utilisation recommandée
ID de la fiche d'établissement Identifie de manière unique un établissement sur Google.

Il ne peut être obtenu directement auprès du propriétaire de l'établissement que sur la page des paramètres avancés de sa fiche d'établissement, comme décrit dans Paramètres avancés de la fiche.

Il est associé au POI représentant l'établissement sur Google. L'association ne sera réussie que si l'établissement a été validé par Google.

En plus des POI, ce format est également compatible avec les types d'établissements de services de proximité et mixtes, définis dans Utiliser une zone desservie sur Google.
  • Le partenaire a une relation commerciale directe avec le propriétaire de l'établissement.
  • Pour les établissements de type "services de proximité" ou "mixte", il s'agit du moyen privilégié d'envoyer ces lieux.
Informations sur le lieu Représentation structurée d'un POI, fournissant des champs distincts pour le nom du lieu, les composants de l'adresse et des indications supplémentaires telles que le numéro de téléphone, le site Web et les coordonnées.

Il s'agit de la méthode privilégiée lorsque l'obtention d'un ID de fiche d'établissement auprès du propriétaire du POI n'est pas possible.
  • Le lieu provient du fournisseur ou du propriétaire des données au format d'adresse, par exemple à l'aide d'un outil destiné aux fournisseurs.
  • Le lieu n'a pas d'adresse précise, mais peut être identifié par son nom et ses coordonnées, comme une attraction ou un voyagiste situé dans une zone reculée telle qu'un désert ou une route sans nom.
  • Dans la mesure du possible, privilégiez ce format plutôt que de faire correspondre l'adresse à un ID de lieu à l'aide de l'API Places afin que Google puisse utiliser des informations supplémentaires telles que le numéro de téléphone ou le site Web pour améliorer la précision de la mise en correspondance.
ID de lieu Identifie de manière unique un POI sur Google.

Vous pouvez l'obtenir à l'aide des points de terminaison de l'API Places, par exemple Place Search ou Place Autocomplete, ou manuellement à l'aide de l'outil Trouver des correspondances de lieux dans le Centre d'activités à découvrir.
  • Le lieu provient du fournisseur ou du propriétaire des données à l'aide d'un outil d'interface utilisateur destiné aux fournisseurs, qui peut, par exemple, utiliser Place Autocomplete pour permettre au propriétaire des données de sélectionner la correspondance correcte dans une liste de candidats possibles.
  • Vous préférez avoir plus de contrôle sur le processus de mise en correspondance, ou vous ne souhaitez pas partager les informations d'adresse brutes.
  • Il s'agit de la méthode privilégiée lorsque l'obtention d'un ID de fiche d'établissement auprès du propriétaire du POI n'est pas possible et que vous préférez faire correspondre l'adresse à un POI de votre côté à l'aide de l'API Places, plutôt que d'envoyer les informations brutes sur le lieu à Google.
Latitude et longitude Identifient de manière générale une région géographique ou géopolitique telle qu'une ville, une localité ou une destination de voyage.
  • Utilisez ce format lorsque vous souhaitez envoyer un lieu approximatif qui ne représente aucun POI spécifique. Par exemple, lorsque vous souhaitez associer un produit à une ville ou une localité afin qu'il puisse être déclenché dans les annonces Activités à découvrir.
  • Ce format n'est pas adapté à la représentation d'un POI. Pour envoyer des lieux de POI à l'aide de coordonnées, utilisez le format "Informations sur le lieu".
Adresse Represents a POI location as an unstructured single-line address, optionally including the place name.

Obsolète.
Ce format ne sera plus pris en charge à compter du 1er mai 2024.
  • Toutes les utilisations de ce format devront être migrées vers le nouveau format "Informations sur le lieu", qui inclut un champ obligatoire pour le nom du lieu et est compatible avec les formats d'adresse structurés et non structurés formats.
  • Vous pouvez également migrer les indications de lieu concernées vers l'ID de fiche d'établissement ou l'ID de lieu.

Exemples

// Example 1: Business Profile ID, copied from the Advanced settings page
// of the Google Business Profile that manages the POI.
"location": {
  "business_profile_id": 11458995034835395294
}

// Example 2: Place Info with structured address, coordinates, website URL,
// and phone number.
"location": {
  "place_info": {
    "name": "Colosseum",
    "phone_number": "+39 063 99 67 700",
    "website_url": "https://colosseo.it/",
    "coordinates": {
      "latitude": 41.8902102,
      "longitude": 12.4922309
    },
    "structured_address" {
      "street_address": "Piazza del Colosseo, 1",
      "locality": "Roma",
      "administrative_area": "RM",
      "postal_code": "00184",
      "country_code": "IT"
    }
  }
}

// Example 3: Place Info with unstructured address.
"location": {
  "place_info": {
    "name": "Eiffel Tower",
    "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
  }
}

// Example 4: Place Info using place name and coordinates only. This
// configuration is useful for matching POIs located in remote areas without
// an exact street address, such as POIs located in deserts or on unnamed
// roads.
"location": {
  "place_info": {
   "name": "Mutitjulu Waterhole",
   "coordinates": {
     "latitude": -25.3511774,
     "longitude": 131.0326859
    }
  }
}

// Example 5: Latitude and longitude.
// This format maintains the old behavior and will only match to the city or
// region.
// For more accurate matching using coordinates, use PlaceInfo instead,
// which includes a mandatory field for the place name.
"location": {
  "lat_lng": {
    "latitude": 51.5072178,
    "longitude": -0.1275862
  }
}

Migrer le champ address vers le nouveau champ place_info

Vous pouvez migrer le champ address non structuré existant vers le nouveau champ place_info en procédant comme suit :

  1. Si les données d'adresse dont vous disposez ne sont pas structurées :
    1. Ajoutez le nom de l'établissement au champ place_info/name.
    2. Placez l'adresse sans le nom de l'établissement dans place_info/unstructured_address.
    3. Supprimez le champ address existant du flux.
    4. Passez à l'étape 3.
  2. Si les données d'adresse dont vous disposez sont structurées :
    1. Ajoutez le nom de l'établissement au champ place_info/name.
    2. Ajoutez les informations d'adresse telles que street_address et postal_address dans place_info/structured_address.
    3. Supprimez le champ address existant du flux.
    4. Passez à l'étape 3.
  3. Ajoutez des données supplémentaires telles que website_url et phone_number pour améliorer la précision de la mise en correspondance.