Utilisation de l'application Map Converter

L'application Map Converter convertit des fichiers de formes ESRI en fichiers de format JSON pouvant être affichés dans un composant de création de cartes géographiques Dojo (module dojox.geo.charting). Il s'agit d'une application Dojo connectée à un service REST s'exécutant sur un serveur. Le calcul est effectué sur le serveur. Les fichiers convertis peuvent être interrogés par le client.
Le serveur implémente des services, tels que le téléchargement de fichiers sur le serveur, la reprojection de fichiers de carte, la simplification de fichiers de carte et la conversion de fichiers de carte au format JSON.

Saisie des paramètres d'entrée

Vous devez indiquer un ensemble de paramètres d'entrée pour la conversion.
  1. Téléchargez les fichiers de formes sur le serveur.
    Vous devez procéder à cette opération pour pouvoir utiliser l'application Map Converter.
    1. Dans le panneau Conversion Settings, cliquez sur le bouton Upload.
      Ou
      Dans le panneau Uploaded Files, cliquez sur le bouton Upload.
    2. Sélectionnez les fichiers à télécharger.
      Pour chaque carte, l'application Map Converter requiert au moins deux fichiers, le fichier .shp et un fichier .dbf. Le fichier .shp contient les formes des éléments de carte. Le fichier .dbf contient les métadonnées associées à chaque élément de carte. Pour sélectionner plusieurs fichiers, maintenez la touche Ctrl enfoncée et sélectionnez des fichiers. La sélection multiple n'est pas possible dans les navigateurs Internet Explorer. Si vous utilisez un navigateur Internet Explorer, vous devez télécharger chaque fichier individuellement.
    3. Téléchargez les fichiers.
      Cliquez sur Open pour télécharger les fichiers sélectionnés.
      La liste des fichiers téléchargés sur le serveur apparaît dans le panneau Uploaded Files. Il ne s'agit pas d'une liste propre à une session ni d'une liste de fichiers authentifiée. Elle répertorie tous les fichiers téléchargés sur le serveur, y compris les fichiers téléchargés par d'autres clients.
      Ce panneau comporte une option permettant de supprimer des fichiers du serveur. Si vous supprimez des fichiers sur le serveur, ne supprimez que des fichiers que vous avez téléchargés. Pour supprimer un fichier, sélectionnez-le puis cliquez sur le bouton de suppression.
  2. Sélectionnez le fichier à convertir.
    Dans le panneau Conversion Settings, dans Shapefile, sélectionnez le fichier à convertir.
  3. Associez des métadonnées à des éléments de carte.
    Dans Feature name, sélectionnez les métadonnées appropriées à votre application.
    Vous sélectionnez les métadonnées à associer à chaque élément de carte pour identifier l'élément et pour le lier au magasin de données dans le widget dojox.geo.charting. Les valeurs qui correspondent aux métadonnées s'affichent dans la sous-fenêtre Map Preview sous forme d'infobulles. Par exemple, si vous sélectionnez NAME, les identificateurs de pays ISO apparaissent dans des infobulles.
  4. Sélectionnez la projection d'entrée.
    Sélectionnez la projection d'entrée appropriée.
    En général, la projection d'entrée est la projection intitulée Longitude/Latitude, qui est une position géographique. Si le fichier de formes a été codé avec une projection différente, sélectionnez cette projection dans la liste.

Saisie des paramètres de sortie

Vous devez indiquer un ensemble de paramètres de sortie pour la conversion.
  1. Sélectionnez et testez la projection de sortie.
    1. Sélectionnez la projection de sortie.
      Sélectionnez la projection de sortie qui semble appropriée à votre carte.
      Ce paramètre spécifie la projection dans laquelle la carte convertie est projetée. Si vous sélectionnez la même projection qu'en entrée, la carte n'est pas projetée. Les projections répertoriées ne sont pas toutes valides pour toutes les cartes. Des résultats inattendus peuvent survenir lorsque des projections inappropriées sont sélectionnées.
    2. Affichez les résultats.
      Cliquez sur Convert.
      La carte convertie est affichée dans la sous-fenêtre de droite.
  2. Sélectionnez le type de coordonnées.
    Sélectionnez des coordonnées de type entier ou virgule flottante pour la carte JSON convertie.
    Les coordonnées de type virgule flottante sont sélectionnées par défaut. Les coordonnées de type entier doivent être sélectionnées explicitement. En général, la sélection de coordonnées de type entier génère un fichier JSON plus petit. Dans ce cas, il se peut que vous deviez choisir une valeur Scale Map to pour la carte afin d'accroître la précision. Habituellement, la valeur par défaut fonctionne bien.
  3. Sélectionnez le niveau minimal de détail.
    Entrez une valeur dans la zone Minimum detail size pour obtenir une carte plus claire mais moins détaillée.
    Le niveau minimal de détail est exprimé en mètres. Il indique qu'aucun détail figurant sur la carte convertie ne dépassera cette distance. Ce paramètre permet d'obtenir un fichier JSON plus petit.
  4. Retirez les artefacts indésirables.
    Sélectionnez Wrap dateline.
    Dans certains cas, la projection de carte peut générer des artefacts indésirables, notamment en cas de projection d'une carte du monde. Cette option peut supprimer de tels éléments mais requiert davantage de temps pour projeter la carte.

Téléchargez le fichier converti en vue de son utilisation dans une application.

Une fois que vous êtes satisfait des résultats de la conversion :
  1. Téléchargez le fichier.
    Cliquez sur Download pour télécharger les données JSON converties.
  2. Intégrez les données dans une application.
    Intégrez les données générées par l'application Map Converter en tant que données de description de carte dans un widget dojox.geo.charting.
    L'exemple suivant suppose que vous avez téléchargé les données JSON sous forme de fichier appelé map.json et explique comment les utiliser.
    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" 
    	"http://www.w3.org/TR/html4/strict.dtd">
    <html lang="en">
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>Use Map Converter Data</title>esources/UploaderFileList.css">
    <script type="text/javascript">
    	var djConfig = {
    		parseOnLoad : true
    	}
    </script>
    <script type="text/javascript" src="../../../dojo_current/dojo/dojo.js"></script>
    <script type="text/javascript">
    	require([ "dojox/geo/charting/widget/Map" ]);
    </script>
    
    </head>
    
    <body class="claro">
    	<div data-dojo-type="dojox.geo.charting.widget.Map"
    		shapeData="map.json" />
    </body>
    </html>
    

Conditions d'utilisation | Commentaires