Structure d'un fichier CSV adapté à Click2Map

Créer mes repères - 16 janvier 2015

Click2map offre la possibilité d'importer des données en provenance de fichiers externes qui doivent pour cela être dans un format compatible. Le principal format d'import est le format CSV : il s'agit d'un format texte standard utilisé pour échanger des données entre des applications différentes. Les fichiers CSV sont faciles à modifier dans des tableurs comme MS Excel, OpenOffice ou Google Spreadsheet.

Les fichiers CSV sont des fichiers textes qui peuvent être ouverts avec la plupart des éditeurs de texte comme le bloc notes de Windows, WordPad, etc.

Ils se distinguent de fichiers textes classiques dans la mesure où ils sont utilisés pour stocker des informations structurées :

  • La première ligne fournit la structure du fichier.
  • Un caractère spécifique est utilisé pour séparer les différents éléments en colonnes. Ce caractère peut être une virgule, un point-virgule ou une tabulation. Le format standard en France est le point-virgule par exemple.

 

La structure CSV de Click2Map

La première ligne d'un fichier Click2Map CSV contient les éléments suivants :

Name, Title, Latitude, Longitude, Description, Address, Street, City, State, Zip, Country, Icon_uri, IconSizeW, IconSizeH, Url_text, Url, Email_text, Email, Group

Cette première ligne est plus importante qu'elle ne pourrait paraître au premier abord : elle constitue la liste de toutes les informations qui peuvent être associées à chaque repère dans une carte.

L'ordre des différents éléments n'est pas important ; assurez-vous simplement que l'ordre dans lequel ces éléments sont placés sur la première ligne est bien le même pour tous les repères. La dénomination des éléments (Name, Title…) n'est pas obligatoire : si votre fichier CSV utilise les dénominations indiquées ci-dessus, Click2Map associera automatiquement les colonnes correspondantes ; dans le cas contraire vous pourrez effectuer cette association durant le processus d'import.

Note : tous les éléments ne sont pas obligatoires : certains peuvent être ignorés, auquel cas Click2Map les considérera comme vides ou leur donnera des valeurs par défaut.

  • Name : le nom de chaque repère doit être unique. Il s'agit de l'information utilisée pour identifier chaque repère. Vous pouvez utiliser ce champ pour stocker un nom en clair ou un numéro d'identification unique.
  • Title : le champ correspond au titre du repère. Les titres ne sont pas obligatoirement uniques et peuvent par exemple représenter différentes catégories de repères (studio, appartement, maison, … etc).
  • Description : ce champ contient la description associée à chaque repère. Le contenu de ce champ peut être au format HTML.
  • Address : ce champ contient des adresses complètes ; si les adresses sont décomposées en colonnes par rue, code postal et ville, utilisez les champs correspondant ci-dessous. Toutes les adresses entrées dans ce champ seront automatiquement géocodées durant le processus d'import. Cela signifie que vous n'avez pas besoin de connaître les coordonnées géographiques d'un repère pour le localiser sur une carte : Click2Map fait la conversion pour vous !
  • Street : ce champ contient le numéro, le type et le nom de la voie d'une adresse postale (par exemple “57 rue Lothaire”). Il doit être associé aux autres champs d'adresse (City, State, Zip, Country) pour que Click2Map puisse géocoder l'adresse associée à un repère. Si l'adresse n'est pas séparée en différentes colonnes, elle peut figurer en entier dans le champ Address ; dans ce cas, laissez le champ Street vide.
  • City : ce champ contient le nom de la ville d'une adresse postale (par exemple “METZ”). Il doit être associé aux autres champs d'adresse (Street, State, Zip, Country) pour que Click2Map puisse géocoder l'adresse associée à un repère. Si l'adresse n'est pas séparée en différentes colonnes, elle peut figurer en entier dans le champ Address ; dans ce cas, laissez le champ City vide.
  • State : ce champ contient le nom de l'état d'une adresse postale (par exemple pour une adresse aux USA). Il doit être associé aux autres champs d'adresse (Street, City, Zip, Country) pour que Click2Map puisse géocoder l'adresse associée à un repère. Si l'adresse n'est pas séparée en différentes colonnes, elle peut figurer en entier dans le champ Address ; dans ce cas, laissez le champ State vide.
  • ZIP : ce champ contient le code d'une adresse postale (par exemple “57000”). Il doit être associé aux autres champs d'adresse (Street, City, State, Country) pour que Click2Map puisse géocoder l'adresse associée à un repère. Si l'adresse n'est pas séparée en différentes colonnes, elle peut figurer en entier dans le champ Address ; dans ce cas, laissez le champ ZIP vide.
  • Country : ce champ contient le nom du pays d'une adresse postale (par exemple “France”). Il doit être associé aux autres champs d'adresse (Street, City, State, Zip) pour que Click2Map puisse géocoder l'adresse associée à un repère. Si l'adresse n'est pas séparée en différentes colonnes, elle peut figurer en entier dans le champ Address ; dans ce cas, laissez le champ Country vide.
  • Latitude : si vous connaissez les coordonnées géographiques d'un repère, utilisez ce champ pour entrer sa latitude.
  • Longitude : si vous connaissez les coordonnées géographiques d'un repère, utilisez ce champ pour entrer sa longitude.
  • Url_text : si vous souhaitez fournir à vos visiteurs un lien direct vers votre site web, utilisez ce champ pour enregistrer le texte visible du lien hypertexte. Par exemple “Visitez notre site web !”. Si ce champ est vide, le contenu du champ suivant URL apparaîtra tel quel.
  • Url : utilisez ce champ pour enregistrer l'adresse Internet désirée. Par exemple : ”http://www.click2map.com”.
  • Email_text : si vous souhaitez fournir à vos visiteurs un lien email, utilisez ce champ pour enregistrer le texte visible du lien. Par exemple “Contactez nous”. Si ce champ est vide, le contenu du champ suivant Email apparaîtra tel quel.
  • Email : utilisez ce champ pour enregistrer l'adresse Email désirée. Par exemple “contact@click2map.com”.
  • Group : ce champ contient le nom de groupe/sous-groupe de chaque repère. Si ce champ est vide, le repère sera enregistré à la racine de la carte. Si vous souhaitez placer un repère dans un groupe, entrez simplement le nom de ce groupe dans ce champ. Les groupes peuvent aussi contenir des sous-groupes. Si vous souhaitez placer un repère dans un sous-groupe, entrez simplement le nom de ce sous-groupe dans ce champ sous la forme “NomGroupe/NomSousGroupe”.
  • Icon_url : ce champ contient l'adresse web complète de l'icône associée à un repère. Si ce champ est vide, c'est l'icône par défaut de la carte cible qui sera utilisée.
  • IconSizeW : ce champ indique la largeur d'une icône, en pixels. Ne renseignez ce champ que si vous souhaitez déformer l'image d'origine. Si ce champ est vide, Click2Map transformera l'image à la bonne taille en respectant le ratio hauteur/largeur.
  • IconSizeH : ce champ indique la hauteur d'une icône, en pixels. Ne renseignez ce champ que si vous souhaitez déformer l'image d'origine. Si ce champ est vide, Click2Map transformera l'image à la bonne taille en respectant le ratio hauteur/largeur.

N'attendez pas !

Enregistrez-vous maintenant