Bibliothèque de lieux
La Bibliothèque de lieux contient les lieux de votre organisation sous forme de collections : vos magasins, vos annonces immobilières, vos établissements. Vous importez une collection une fois, depuis un fichier, une Google Sheet ou un flux, vous vérifiez où chaque lieu a été placé, puis vous la publiez. Toutes les cartes de votre organisation peuvent alors l'afficher, sous forme de repères, de localisateur de magasins ou de page d'annonces, et Kaleidr AI répond sur ces cartes aux questions à partir de ses lieux.
Une collection n'est pas un jeu de données sur une carte. Un jeu de données appartient à la seule carte à laquelle vous l'avez ajouté ; une collection appartient à l'organisation, et vous la mettez à jour à un seul endroit pour toutes les cartes qui l'affichent.
| Jeux de données sur une carte | Collections de la Bibliothèque de lieux | |
|---|---|---|
| Appartient à | La carte à laquelle vous l'avez ajouté | L'organisation |
| Contient | N'importe quel tableau, fichier géographique ou image superposée | Des lieux : un point par ligne, avec un nom |
| Mis à jour en | Remplaçant le jeu de données sur chaque carte | Une importation, sur toutes les cartes qui affichent la collection |
| Colonnes privées | Non : les visiteurs reçoivent toutes les colonnes | Oui : une colonne marquée Privée ne quitte jamais Studio |
| Mises en page localisateur et annonces | Non | Oui |
| Offres | Free, Pro et Enterprise | Free, Pro et Enterprise |
Trouver la Bibliothèque
Connectez-vous à Kaleidr Studio et choisissez Données dans la barre de gauche. La Bibliothèque liste les collections de votre organisation, avec pour chacune le nombre d'enregistrements, la date de sa dernière publication, si elle s'actualise selon une planification et le nombre de cartes qui l'affichent. La bande du haut indique combien de collections et de lieux votre offre autorise et combien vous en utilisez.
Les propriétaires, les administrateurs et les membres peuvent créer, importer et modifier des collections. Les lecteurs peuvent les ouvrir et lire leurs lieux.
Collections
Choisissez Nouvelle collection, choisissez un type et donnez-lui un nom. Le type détermine les champs que l'assistant d'importation propose en premier et l'apparence de la fiche d'un lieu :
| Type | Pour | Champs proposés en premier |
|---|---|---|
| Magasins | Des points de vente. Le kit Retail. | Nom, adresse, catégorie, horaires, fuseau horaire, téléphone, site web, lien d'action, votre identifiant, statut |
| Annonces | Des biens à vendre ou à louer. Le kit Property. | Nom, adresse, prix, devise, chambres, salles de bain, photo, statut, lien d'action, téléphone, votre identifiant, description |
| Établissements | Hôtels, restaurants et attractions. Le kit Hospitality. | Nom, adresse, catégorie, horaires, téléphone, site web, photo, description, lien d'action, votre identifiant |
| Arrêts | Des arrêts programmés, comme la tournée d'un food truck ou des points de ramassage. Le kit Location. | Nom, adresse, horaires (les plages de service), fuseau horaire, statut, véhicule, dates de service, description, votre identifiant |
| Véhicules | Les véhicules d'une flotte, affichés en direct sur une carte. Voir Suivi en direct. | Aucun : les véhicules sont ajoutés à la flotte dans Studio, pas importés |
| Personnalisée | Tous les autres lieux | Nom, adresse, catégorie, description, votre identifiant |
Chaque type peut aussi contenir vos propres colonnes. Une collection Magasins, Annonces, Établissements ou Arrêts commence avec la fiche, les filtres et les actions de son kit, que vous pouvez modifier. Une collection Véhicules n'accepte aucune importation : ses véhicules se gèrent dans la section Flotte de Studio.
Les Horaires d'une collection Arrêts sont ses plages de service. Un arrêt dont le Statut est paused n'est desservi aucun jour ; une colonne Véhicule nomme le véhicule qui dessert l'arrêt ; une colonne Dates de service liste les seules dates où il est desservi. Voir Horaires des arrêts.
Importer vos données
Choisissez Importer des données dans une collection. L'assistant d'importation comporte cinq étapes.
1. Ajouter vos données
Apportez les données de l'une de trois façons :
| Source | Ce qu'il faut fournir | Actualisable |
|---|---|---|
| Un fichier | CSV, TSV, Excel, ODS, GeoJSON, KML, GPX ou un shapefile zippé | Non : importez un nouveau fichier pour mettre à jour |
| Une Google Sheet | Le lien du tableau, commençant par https://docs.google.com/spreadsheets/d/. Partagez d'abord le tableau en « Tous les utilisateurs disposant du lien peuvent consulter » ; un tableau qui demande une connexion ne peut pas être lu. Un lien vers un onglet lit cet onglet. | Oui |
| Un flux | Une adresse https:// d'un fichier CSV, JSON ou GeoJSON | Oui |
- Un lieu est un point. Un fichier cartographique doit contenir des points ; les lignes et les surfaces sont refusées. Les images superposées comme les GeoTIFF ne sont pas des lieux et sont refusées aussi.
- Chaque ligne a besoin d'un nom, et d'une adresse ou de coordonnées. Une ligne avec des coordonnées est placée exactement là où elles l'indiquent. Une ligne avec seulement une adresse est placée à partir de l'adresse.
- Télécharger un tableau d'exemple vous donne un exemple rempli pour le kit de la collection, avec les colonnes que lit la fiche du kit.
2. Associer les colonnes
Studio affiche une ligne par colonne de vos données, avec des valeurs d'exemple et le champ auquel la colonne a été associée. Une puce indique comment :
| Puce | Signification |
|---|---|
| Associée | Le nom de la colonne est un nom connu pour le champ, comme « Latitude » ou « Store Name ». |
| Correspondance proche | Le nom de la colonne est proche d'un nom connu. |
| Suggérée par l'IA | Kaleidr AI a suggéré le champ d'une colonne que les noms ne permettaient pas de trancher. Elle lit vos noms de colonnes et les cinq premières lignes pour suggérer une association, et n'écrit ni ne modifie jamais vos données. La suggestion compte dans l'utilisation de Kaleidr AI de votre organisation. |
Vérifiez chaque ligne et changez tout champ erroné. Une colonne peut être :
- Un champ standard du type, comme Nom, Adresse, Horaires ou Prix. Les champs standard sont toujours publics.
- Une colonne personnalisée, avec votre propre libellé, et Publique ou Privée.
- Ignorer, pour laisser la colonne de côté.
Les colonnes de rue, de ville, de région, de code postal et de pays sont réunies en une seule adresse. La latitude et la longitude peuvent être deux colonnes, ou une seule colonne contenant les deux, dans un ordre ou dans l'autre. Choisissez le Fuseau horaire dans lequel sont écrits les horaires d'ouverture de la collection.
Les colonnes privées restent chez vous. Une colonne privée est conservée pour vous dans Studio, et n'est jamais envoyée au navigateur d'un visiteur ni lue par Kaleidr AI. Pour garder privé un champ standard comme un numéro de téléphone, associez-le plutôt à une colonne personnalisée privée.
3. Placer les repères
Studio place chaque ligne sur la carte. Les lignes avec des coordonnées les conservent. Les lignes avec une adresse sont placées à partir de l'adresse uniquement, jamais à partir du nom du lieu, si bien que deux succursales d'une même enseigne ne peuvent pas se retrouver l'une sur l'autre.
Studio indique ensuite combien de lignes sont Placés, combien sont À vérifier et combien sont Introuvables, avec une liste de vérification à côté d'une carte :
- Accepter le repère conserve un repère que Studio a placé avec une faible confiance.
- Corriger le repère vous permet de faire glisser le repère, ou de cliquer sur la carte, là où se trouve le lieu.
- Retirer exclut la ligne de cette importation.
Une ligne sans repère ne peut pas être publiée. Corrigez-la, retirez-la, ou choisissez Ignorer les lignes sans repère pour publier sans ces lignes.
4. Nettoyer
Studio propose des modifications, regroupées par type, et ne change rien tant que vous n'acceptez pas :
| Type | Ce qu'il repère |
|---|---|
| Doublons | Des lignes avec le même identifiant, ou le même nom au même endroit. Accepter conserve la première ligne. |
| Horaires | Des horaires d'ouverture écrits autrement, comme Mon-Fri 9am-5pm; Sat 10-4, réécrits sous une seule forme. Les horaires que Studio ne sait pas lire sont signalés sur la ligne et laissés vides. |
| Catégories | Des graphies d'une même catégorie qui diffèrent par la casse, les espaces ou le pluriel, fusionnées dans les catégories existantes de la collection. |
| Sites web | Une adresse web sans https://, complétée. |
Choisissez Accepter ou Garder l'original pour chacune, ou Tout accepter. Chaque modification demande une décision avant la publication.
5. Publier
La publication remplace les lieux de la collection par cette importation. Toutes les cartes qui affichent la collection montrent les nouveaux lieux à leur prochain chargement. Un lieu garde son identité d'une importation à l'autre, si bien qu'un lien ou une fiche qui pointe vers un magasin pointe toujours vers lui après l'actualisation des données.
Après la publication, vous pouvez choisir Ajouter à une carte et, pour une Google Sheet ou un flux, Planifier l'actualisation.
Garder les données à jour
La section Actualisation d'une collection importée depuis une Google Sheet ou un flux relit ce lien :
- Actualiser maintenant, dans toutes les offres, relit le lien avec les associations de colonnes utilisées la dernière fois. Si les colonnes du tableau ont changé, l'importation s'arrête à Associer les colonnes pour que vous vérifiiez.
- Une planification, dans les offres Pro et Enterprise, actualise à l'intervalle choisi, pas plus souvent que votre offre ne l'autorise (voir Limites). Avec Publier automatiquement activé, une actualisation se publie d'elle-même, sauf si elle doit être vérifiée ou si elle change le nombre de lieux de plus de moitié ; elle vous attend alors.
- Des échecs répétés mettent la planification en pause. La section affiche la dernière exécution et son résultat.
Colonnes, fiche, filtres et actions
Ouvrez une collection pour changer son apparence. Chaque partie est une section repliable :
- Enregistrements : chaque lieu, avec une recherche. Les colonnes privées sont signalées.
- Colonnes : le libellé de chaque colonne, Publique ou Privée, son Emplacement sur la fiche et son ordre. Un changement de visibilité s'applique à toutes les cartes qui affichent la collection.
- Fiche et filtres : un Aperçu de la fiche en direct, les Filtres des visiteurs qu'offre un localisateur de magasins ou une page d'annonces, et les Actions du lieu sur chaque fiche.
La fiche présente un lieu quand un visiteur le sélectionne. Les emplacements de la fiche déterminent ce qui va où : Titre, Sous-titre, Image, Prix, jusqu'à trois Badges, jusqu'à quatre Lignes de détail et une ligne de Mention. Un champ qu'un lieu n'a pas est omis de sa fiche, jamais affiché vide. Une fiche Magasins affiche Ouvert maintenant ou Fermé, calculé à partir des horaires du lieu dans son fuseau horaire. Une fiche Annonces affiche la mention, comme « Annonce avec l'aimable autorisation de » un courtier et un agent, juste sous le prix.
Filtres des visiteurs, dans l'ordre que vous définissez :
| Filtre | Les visiteurs peuvent |
|---|---|
| Recherche | Saisir un nom, une adresse ou une catégorie. |
| Catégorie | Choisir une ou plusieurs catégories. |
| Prix | Définir un minimum et un maximum. |
| Chambres / Salles de bain | Choisir 1+, 2+, 3+ ou 4+. |
| Ouvert maintenant | N'afficher que les lieux ouverts en ce moment. Les lieux sans horaires sont masqués tant qu'il est activé. |
Actions du lieu, jusqu'à quatre sur chaque fiche :
| Action | Ce que le visiteur obtient |
|---|---|
| Lien | Un bouton qui ouvre l'une de vos pages dans un nouvel onglet, comme « Shop » ou « Schedule a Tour ». Écrivez l'adresse une fois avec {id} à l'endroit de l'identifiant de chaque lieu ; le Lien d'action propre d'un lieu la remplace. Les adresses doivent commencer par https://. |
| Itinéraire | Un itinéraire tracé sur la carte depuis la position du visiteur, ou depuis un lieu qu'il recherche, et des boutons qui ouvrent l'itinéraire vers le lieu dans Apple Maps ou Google Maps. |
| Appeler | Un lien téléphonique vers le numéro du lieu. |
| Demande | Un bouton comme Reserve, Schedule a Tour ou Request Pickup qui ouvre un formulaire de demande. La demande arrive dans la boîte de réception de votre organisation. Voir Demandes de réservation. |
Ajouter une collection à une carte
Deux façons, avec le même résultat :
- Dans le panneau Données d'une carte, choisissez Ajouter depuis la bibliothèque et sélectionnez une collection.
- Dans une collection, choisissez Ajouter à une carte et sélectionnez une carte.
La collection devient une couche de la carte, que vous stylez comme n'importe quelle autre. Les annonces sont dessinées comme des étiquettes de prix ; les autres types comme des points. Une carte peut afficher plusieurs collections, et une collection peut figurer sur autant de cartes de votre organisation que vous le souhaitez.
Quand la carte est publiée, ses visiteurs voient les colonnes publiques de la collection et rien d'autre. Mettre à jour la collection met à jour toutes les cartes qui l'affichent, sans nouvelle publication.
Kaleidr AI répond à partir d'elle. Sur une carte publiée avec Control Tower activé, le panneau Ask Kaleidr répond à des questions comme « le magasin le plus proche avec un parking » à partir des lieux de la collection et de leurs colonnes publiques, et le panneau indique que ses réponses sont générées par une IA. Voir Chat sur une carte publiée.
Intégrez-la comme localisateur de magasins ou page d'annonces. Les mises en page locator et listings affichent la carte à côté d'une liste consultable de la collection, avec ses filtres et ses fiches. Voir Mises en page de lieux.
Kits
Quatre types de collection sont livrés avec un kit : une fiche, des filtres, des actions et une mise en page viewer qui fonctionnent ensemble, et un tableau d'exemple pour commencer.
| Kit | Type de collection | Mise en page | Filtres | Actions |
|---|---|---|---|---|
| Retail | Magasins | locator | Recherche, Catégorie, Ouvert maintenant | Itinéraire, Appeler, Shop |
| Property | Annonces | listings | Prix, Chambres, Salles de bain | Schedule a Tour, Contact Agent |
| Hospitality | Établissements | guide | Recherche, Catégorie, Ouvert maintenant | Book, Itinéraire, Reserve |
| Location | Arrêts | live | Recherche, Ouvert maintenant | Itinéraire, Request Pickup |
Les modèles de kit du générateur de modèles créent une carte qui contient déjà une collection d'exemple de cette forme, et écrivent le code d'intégration avec la mise en page du kit. Remplacez les lieux d'exemple par les vôtres en important dans cette collection. La collection d'exemple compte dans votre limite de collections ; à la limite, la carte est créée sans elle. Le modèle Location contient des arrêts d'exemple et aucune flotte : ajoutez vos véhicules dans la section Flotte de Studio. Les actions Reserve et Request Pickup apparaissent dès que votre organisation accepte les demandes.
Supprimer une collection
Supprimer la collection se trouve en bas d'une collection. Si certaines de vos cartes affichent la collection, Studio les liste d'abord, et Supprimer quand même la supprime malgré tout. Supprimer une collection supprime définitivement ses lieux et ses fichiers importés. Les cartes qui l'affichaient continuent de fonctionner, sans elle.
Quand une organisation est supprimée, ses collections sont supprimées avec elle.
Limites
| Limite | Free | Pro | Enterprise |
|---|---|---|---|
| Collections | 3 | 25 | Fixé dans votre contrat |
| Lieux dans une collection | 1 000 | 25 000 | 100 000 |
| Lieux dans toutes les collections | 3 000 | 250 000 | Fixé dans votre contrat |
| Actualisation planifiée | Aucune : Actualiser maintenant uniquement | Quotidienne au plus | Horaire au plus |
| Taille d'un fichier, d'un tableau ou d'un flux | 32 Mio | 64 Mio | 64 Mio |
Dans toutes les offres, une collection contient au plus 100 000 lieux et 100 colonnes, et une cellule au plus 2 000 caractères. Une limite n'arrête que le travail nouveau : une organisation au-delà d'une limite conserve ce qu'elle a publié.
Sur une carte publiée, les recherches d'adresse et les itinéraires sont chacun limités à 20 par minute pour un visiteur et à 2 000 par jour pour une carte. Ils ne comptent pas dans votre utilisation de Kaleidr AI.