Vue d'ensemble

La librairie tmaps version 2 est disponible uniquement en module javascript au format ES6.

Le path du module est /v2/mod.js.

Les définitions au format typescript sont également disponibles (/v2/defs/public.d.ts). Le fichier peut être copié en local pour le développement.

La création de la carte se fait en appelant la fonction createMap avec les options nécéssaires et le type de carte désiré.

Les options inclues:

target: l'élément du DOM à remplacer.
center: les coordonnées du centre de la carte.
lang: le code à deux lettres de la langue (optionel); la langue du navigateur est utilisée si l'option n'est pas définie.

Information technique

L'élément cible donné dans la configuration est remplacé par un Web Component. La carte est dans le Shadow Dom de l'élément, ceci afin d'isoler le style utilisé de celui de la page.

Exemple

javascript

/** @typedef {import('./public.d.ts').BaseConf} BaseConf */
/** @typedef {import('./public.d.ts').MapTypes} MapTypes */
/** @typedef {import('./public.d.ts').PanOptions} PanOptions */
/** @typedef {import('./public.d.ts').ZoomOptions} ZoomOptions */

import {createMap, MapTypes, PanOptions, ZoomOptions}
  from 'https://tmaps.rc.preprod:8181/v2/mod.mjs';

const targetElement = document.querySelector('map-placeholder');
/** @type {BaseConf} */
const options = {
  target: targetElement,
  center: {
    lat: 46.16175,
    lon: -1.20431
  },
  zoom: 10,
  allow_pan: PanOptions.always,
  allow_zoom: ZoomOptions.with_modifier
};
const map = await createMap(MapTypes.TouristicMaps,options);

typescript

/// <reference path="./public.d.ts">

import {createMap, BaseConf, MapTypes, PanOptions, ZoomOptions}
  from 'https://tmaps.rc.preprod:8181/v2/mod.mjs';

const targetElement = document.querySelector('map-placeholder')!;
const options: BaseConf = {
  target: targetElement,
  center: {
    lat: 46.16175,
    lon: -1.20431
  },
  zoom: 10,
  allow_pan: PanOptions.always,
  allow_zoom: ZoomOptions.with_modifier
};
const map = await createMap(MapTypes.TouristicMaps, options);

carte