Lieu et point d'intérêt

Le flux de produits vous permet de spécifier des points d'intérêt associés au produit de plusieurs façons. Google utilise ces informations pour présenter le produit aux utilisateurs lorsque des POI ou des destinations pertinents sont recherchés.

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

Lieux associés et relation_type

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 "pertinent" peut varier selon les lieux, mais les éléments qui ne doivent généralement pas être marqués comme liés incluent les vues d'un POI lors d'une croisière ou d'une visite en bus, par exemple, ou les points de rendez-vous d'une visite guidée (utilisez plutôt le champ meeting_point). Les trois relation_types sont les suivants:

• RELATED_NO_ADMISSION: l'emplacement est lié, mais l'option de produit n'inclut pas l'admission, ni l'admission, elle n'est pas pertinente. Par exemple, si le lieu est un carré mis en évidence lors d'une visite de la ville.

• ADMISSION_TICKET: la relation autorise l'accès à ce lieu associé.

• SUPPLEMENTARY_ADDON: la relation déclare un service supplémentaire qui ne redirige pas l'utilisateur vers l'emplacement associé. Par exemple, une entrée de parking, une exposition temporaire.

Remarque :Pour être éligibles au module de billets pour des attractions dans la recherche, les produits doivent inclure le type de relation ADMISSION_TICKET pour le POI de l'attraction.

Exemples

relation_type	Exemple
RELATED_NO_ADMISSION	Visite à pied de la tour Eiffel sans y entrer. Visite en hélicoptère autour du Burj Khalifa.
ADMISSION_TICKET	Le billet d'entrée à un zoo peut inclure des suppléments.
SUPPLEMENTARY_ADDON	Évitez les files d'attente sans entrer dans les détails, audioguide sans entrée.
Sans rapport	Croisière permettant de voir le POI au loin. Office de tourisme où commence la visite ou où il est possible d'acheter le billet.

Chaque option de produit peut également comporter un meeting_point pour des types de visites spécifiques dont le point de départ n'est pas clair et doit être déterminé (ex. : visites guidées).

Demander l'ajout d'une nouvelle attraction

Si vous fournissez les billets officiels pour des attractions et remarquez qu'une des attractions avec lesquelles vous travaillez ne figure pas sur Google Things To Do, vous pouvez remplir le formulaire de demande de POI TTD pour demander à ajouter le POI dans le cadre des activités à découvrir.

Remarque :Les requêtes ne sont examinées de façon périodique par lots que par l'équipe produit. Si une attraction est ajoutée, elle s'affiche directement dans l'outil Rechercher des correspondances de lieux du Things To Do Center.

Transmettre des lieux associés à Google

Lors du traitement d'un flux entrant, Google tente de mettre en correspondance les indications d'emplacement fournies sous forme de chaînes textuelles avec les entités internes Google représentant ces emplacements, appelées "POI".

Un POI peut être défini de manière approximative comme un repère nommé associé à un lieu spécifique (coordonnées). Dans le contexte des activités à découvrir, les visites guidées et les attractions touristiques sont des exemples pertinents. Toutefois, de manière générale, un POI peut désigner tout établissement dont le nom et le lieu sont connus de Google.

La mise en correspondance des lieux consiste à mettre en correspondance un lieu associé, sous la forme d'une indication textuelle, à un POI connu de Google, s'il existe dans la base de données Google.

Vous pouvez envoyer un établissement associé à Google de plusieurs façons, en fonction de la source des données de localisation, des exigences contractuelles avec les fournisseurs et du niveau de contrôle que vous souhaitez avoir sur le processus de mise en correspondance.

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

Types d'indices

Type	Description	Utilisation recommandée
ID de la fiche d'établissement	Identifie un établissement de manière unique sur Google. Elle ne peut être obtenue directement qu'auprès du propriétaire de l'établissement via la page des paramètres avancés de sa fiche d'établissement, comme indiqué dans Paramètres avancés de la fiche. Elle est mise en correspondance avec le POI représentant l'établissement sur Google. La mise en correspondance ne sera effective que si l'emplacement de l'établissement a été validé par Google. En plus des POI, ce format est également compatible avec les établissements de services de proximité à domicile et hybrides, définis dans la section Utiliser une zone desservie sur Google.	Le partenaire entretient une relation commerciale directe avec le propriétaire de l'établissement. Il s'agit de la méthode privilégiée pour les établissements de type "zone desservie" ou "hybride".
Informations sur le lieu	Représentation structurée d'un POI, avec des champs distincts pour le nom du lieu et les composants de l'adresse, ainsi que 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 lorsqu'il n'est pas possible d'obtenir un ID de fiche d'établissement auprès du propriétaire du POI.	L'emplacement provient du fournisseur ou du propriétaire des données sous un format d'adresse (par exemple, à l'aide d'un outil destiné au fournisseur). Le lieu n'a pas d'adresse précise, mais peut être identifié grâce à son nom et ses coordonnées (par exemple, une attraction ou un voyagiste situé dans une zone isolée, comme un désert ou une route sans nom). Dans la mesure du possible, privilégiez ce format à la mise en correspondance de l'adresse avec un ID de lieu à l'aide de l'API Places. Google pourra ainsi 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 un POI de manière unique sur Google. Elle peut être récupérée à 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 Things to Do Center.	L'établissement provient du fournisseur ou du propriétaire des données à l'aide d'un outil d'UI visible par le fournisseur. Celui-ci peut, par exemple, utiliser Place Autocomplete pour permettre au propriétaire des données de sélectionner la bonne correspondance dans une liste de candidats possibles. Vous préférez avoir davantage 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 lorsqu'il n'est pas possible d'obtenir un ID de fiche d'établissement auprès du propriétaire d'un POI, 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	Identifiez de manière approximative 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 une position approximative qui ne représente aucun POI spécifique. (par exemple, lorsque vous souhaitez associer un produit à une ville ou une localité pour qu'il puisse s'afficher dans des annonces Activités à découvrir). Ce format ne convient pas pour représenter un POI. Pour envoyer des lieux de POI à l'aide de coordonnées, utilisez le format "Place Info".
Adresse	Représente l'emplacement d'un POI sous la forme d'une adresse non structurée sur une seule ligne, incluant éventuellement le nom du lieu. Obsolète. Ce format ne sera plus accepté à partir du 1er mai 2024.	Vous devrez migrer vers le nouveau format d'informations sur le lieu pour toute utilisation de ce format. Celui-ci comprend un champ obligatoire pour le nom du lieu et accepte les formats d'adresses structurés et non structurés. Vous pouvez également migrer les indications de lieu concernées vers l'ID de la 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": "[phone]",
    "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 non structuré address existant vers le nouveau champ place_info en procédant comme suit:

1. Si vos données d'adresses ne sont pas structurées :
   1. Ajoutez le nom de l'entreprise au champ place_info/name
   2. Indiquez l'adresse sans le nom de l'entreprise dans place_info/unstructured_address.
   3. Supprimez le champ address existant du flux.
   4. Passer à l'étape 3
2. Si vos données d'adresse sont structurées :
   1. Ajoutez le nom de l'entreprise 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. Passer à 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.