Responsabilité intégrateur (bientôt disponible)

Apidae produit un balisage fidèle à la fiche. Certaines informations ne sont connues que du site qui publie la page : elles restent à votre charge.

Identifiant de l’entité (@id)

Apidae ne connaît pas l’URL de votre page : le balisage ne contient pas de @id. Nous recommandons d’ajouter l’URL canonique de la page :

jsonLd["@id"] = "https://www.mon-site.fr/hebergements/hotel-du-lac";

Pour une manifestation à plusieurs dates (@graph), ajoutez un suffixe par événement, par exemple https://www.mon-site.fr/agenda/fete-du-lac#periode-11 (l’identifier Apidae de chaque événement contient l’identifiant de la période après le tiret).

L’identifier émis est l’identifiant Apidae de la fiche (suffixé de l’identifiant de période pour les événements).

Insertion dans la page

Le JSON-LD d’Apidae est échappé pour être inséré tel quel dans une balise <script type="application/ld+json"> : <, >, & et les séparateurs de ligne Unicode y sont écrits en \uXXXX. Si vous le retraitez, conservez cet échappement (voir 01 — Démarrage).

Éditeur de la page (publisher)

Le balisage indique :

  • creator : le membre Apidae propriétaire de la donnée (office de tourisme…), qui est la source de l’information ;
  • sdPublisher : Apidae Tourisme, producteur du balisage.

L’éditeur du site qui publie la page (publisher) n’est pas renseigné par Apidae. Ajoutez-le si besoin. Si vous maîtrisez la page, vous pouvez aussi envelopper l’entité dans un WebPage (mainEntity), qui est plus conforme au vocabulaire pour dateModified et publisher.

Cohérence avec le contenu visible

Google exige que le balisage décrive ce qui est visible sur la page. Ne publiez pas un balisage qui annonce des informations absentes de la page : horaires, tarifs, labels…

  • Publiez le JSON-LD de la langue de la page, pas les autres.
  • Si votre page n’affiche pas une information, retirez la propriété correspondante du JSON-LD.

Événements passés

Le balisage est calculé à chaque appel de l’API et ne contient que les périodes non terminées à cet instant. Si vous conservez la réponse en cache, une période peut s’achever après l’appel. Ne publiez pas un Event dont la endDate est passée.

Aspects

Un aspect (hiver, été, handicap…) a son propre balisage (aspects[].schemaOrg), calculé sur la fiche dont les champs propres à l’aspect remplacent ceux de la fiche standard. Publiez-le sur la page qui présente la fiche sous cet aspect.

Robots des moteurs génératifs

Pour être cité par les moteurs génératifs, ne bloquez pas leurs robots d’indexation (GPTBot, ClaudeBot, PerplexityBot, Google-Extended…) dans le robots.txt de votre site.

Avis clients

Apidae ne gère pas d’avis clients. Si votre site en affiche via un service tiers, vous pouvez compléter le balisage avec aggregateRating ou review.

Limites connues

  • Horaires : Apidae ne produit openingHoursSpecification que si les horaires sont saisis avec des heures d’ouverture et de fermeture précises. Les motifs du type « le premier lundi du mois » et les jours fériés ne sont pas représentables. Dans ces cas, rien n’est produit plutôt qu’une information fausse ; le texte d’horaires reste à afficher sur la page.
  • Heures d’arrivée et de départ des hébergements : non disponibles dans le modèle Apidae.
  • Statut « annulé » des manifestations : non émis. Une manifestation « fermée temporairement » n’a simplement pas de eventStatus.
  • Types en cours de stabilisation dans schema.org (TouristTrip, TouristDestination, sdPublisher) : utilisés quand ils sont les plus justes. Ils sont valides, mais pas encore exploités par tous les moteurs.