Fiche d'un site

La fiche d'un site rassemble tout ce que la recherche de proximité renverra à son sujet : comment il s'appelle, où il se trouve, comment le joindre et quand il est ouvert. Elle s'ouvre en cliquant sur un site depuis la liste d'un référentiel, ou en créant un site avec le bouton Ajouter un site.

Identité

1. L'identifiant externe — figé après création : c'est la clé de rapprochement avec votre système source.
2. Le statut du site — Actif ou désactivé.
3. Le panneau Position — d'où viennent les coordonnées, et comment les corriger.

Le bloc Identité réunit quatre champs :

• Identifiant externe — le vôtre, celui de votre ERP ou de votre tableur. Il sert d'adresse au site dans l'API (…/sites/PARIS-01) et devient donc non modifiable une fois le site créé : le changer reviendrait à créer un autre site. Choisissez-le au moment de la création, en reprenant la référence que vos équipes utilisent déjà.
• Nom public — celui que verront vos visiteurs. Seul champ obligatoire avec l'identifiant.
• Nom interne — celui de vos équipes, jamais destiné à l'affichage public. Il est cherchable dans la liste des sites, ce qui permet de retrouver un point par son code maison.
• Description — un texte libre publié avec le site.
• Fuseau horaire — Europe/Paris par défaut. C'est dans ce fuseau que sont interprétés les horaires, donc que l'API calcule si le site est ouvert à l'instant de la requête. Un site outre-mer avec un fuseau resté sur Paris sera annoncé ouvert au mauvais moment.

Adresse et position

L'adresse se saisit en quatre champs — numéro et voie, complément, code postal, commune —, et c'est elle qui détermine la position du site : la position se recalcule à l'enregistrement. TrustyData résout l'adresse contre le référentiel BAN officiel (IGN) et pose le marqueur.

Le panneau Position

À droite de la fiche, le panneau Position dit d'où viennent les coordonnées. Il a deux états, et son titre les nomme :

Titre du panneau	Ce que ça veut dire
Position calculée D'après l'adresse du site	Les coordonnées viennent du géocodage, et suivront les modifications de l'adresse
Position corrigée à la main Elle ne suit plus l'adresse	Vous avez déplacé le marqueur ou saisi des coordonnées : corriger l'adresse ne les bougera plus

La pastille en haut à droite du panneau annonce l'état que l'enregistrement produira, pas celui d'avant votre geste : elle passe à Position fournie dès que vous déplacez le marqueur, avant même d'avoir validé.

Vous pouvez déplacer le marqueur sur la carte, ou saisir directement une latitude et une longitude en degrés décimaux. Les deux vont ensemble : renseignez-les toutes les deux, ou aucune. Le bouton Revenir au géocodage automatique efface votre correction et rend la main à l'adresse.

Étiquettes

Les étiquettes sont des mots-clés libres publiés avec le site : terrasse, accessible, click-and-collect, ouvert-dimanche. Tapez puis validez avec la touche Entrée ; vous pouvez aussi coller plusieurs étiquettes séparées par des virgules.

Elles ne servent pas qu'à documenter : la recherche de proximité peut filtrer dessus, et le filtre est conjonctif — un site doit porter toutes les étiquettes demandées pour ressortir. Gardez donc un vocabulaire court et régulier d'un site à l'autre : accessible et acces-pmr employés au hasard rendront le filtre inutilisable.

Contacts et liens

Les contacts (téléphone, e-mail) et les liens (vitrine, réseaux sociaux, page de réservation) se saisissent en listes ordonnées. Les flèches montent et descendent une ligne ; cet ordre est celui que renvoie l'API, donc celui que vous afficherez. Le libellé est facultatif mais utile quand un site a plusieurs numéros — Standard, Réservations, Service après-vente.

Horaires et exceptions

Les horaires se saisissent jour par jour, en créneaux. Un jour sans créneau est Fermé. Le bouton + en bout de ligne ajoute un créneau — c'est ainsi qu'on saisit une coupure du midi : deux créneaux le même jour.

Deux créneaux qui se recouvrent sont signalés : le service n'en gardera qu'un à l'enregistrement. Corrigez-les plutôt que de laisser l'API trancher à votre place.

Les exceptions couvrent les jours fériés, les congés et les ouvertures particulières. Une exception porte sur une plage de dates — même date de début et de fin pour un jour unique —, un libellé, et le choix entre Fermé et Horaires aménagés. Une exception prime sur la semaine type sur toute la plage qu'elle couvre : inutile de retoucher l'hebdomadaire pour un jour férié.

C'est de ces deux blocs que l'API tire le champ ouverture qu'elle renvoie à chaque résultat de recherche : ouvert ou fermé à l'instant de la requête, et l'horodatage de la prochaine ouverture ou fermeture, calculés dans le fuseau du site.

Enregistrer

La barre du bas suit l'état de la fiche : À jour tant que rien n'a changé, Modifications non enregistrées dès la première saisie. Annuler rétablit la fiche telle qu'elle était à l'ouverture ; Enregistrer valide, et c'est à ce moment que la position se recalcule si l'adresse a bougé.

Rien n'est écrit tant que vous n'avez pas enregistré : quitter la page sans valider ne change rien à la donnée servie par l'API.

Retirer un site

Le bloc Retirer ce site, en bas du panneau de droite, propose deux gestes qui n'ont pas du tout la même portée :

• Désactiver ce site — il sort des recherches, mais reste consultable et modifiable, et un import qui le ramène le réactive. C'est le geste courant pour une fermeture temporaire ou un site en travaux. Un site désactivé ne compte pas dans la capacité de votre plan.
• Supprimer définitivement — la fiche et son historique disparaissent. Rien ne les restaure.

Et ensuite

• Mes lieux — référentiels, liste des sites, filtres et carte
• Mes lieux par l'API — écrire les mêmes fiches depuis votre système, et chercher les sites les plus proches