Création de modèles d'applications Web
Pour créer votre propre modèle, vous pouvez télécharger et modifier un des modèles existants, mettre à jour une application Web existante pour utiliser le contenu d'ArcGIS Online ou créer une nouvelle application Web à l'aide d'une des API Web ArcGIS. Quelle que soit la manière dont vous créez votre propre modèle, vous utiliserez des paramètres URL et des cartes Web. Vous pouvez utiliser des groupes si vous créez un modèle de groupe et vous pouvez envisager des conditions supplémentaires pour utiliser des cartes de base Bing, accéder à des cartes non publiques et utiliser des ressources qui nécessitent un proxy ou un service CORS (Cross-Origin Resource Sharing). Vous ajouterez également votre élément à ArcGIS Online et, si votre organisation prévoit d'utiliser votre modèle dans sa bibliothèque des modèles, vous le partagerez avec le modèle de carte ou le groupe de modèles de groupes de votre organisation.
Astuce:Cette rubrique explique comment créer un modèle d'application Web. Une fois que vous avez créé votre application, vous pouvez la rendre configurable. Les modèles configurables permettent aux utilisateurs de personnaliser l'apparence et le comportement de l'application. Pour plus d'informations sur la création de modèles configurables, reportez-vous à la rubrique Ajouter des paramètres configurables à vos modèles.
Paramètres URL
Lorsque vous utilisez un modèle, spécifiez la carte Web ou le groupe à afficher en incluant le paramètre webmap ou group dans l'URL du modèle. Les modèles affichent le contenu provenant d'une carte Web ou d'une groupe en spécifiant un ID comme paramètre URL. Les ID des cartes Web sont spécifiés avec le paramètre webmap et le contenu des groupes est spécifié avec le paramètre group. Pour que votre modèle personnalisé fonctionne avec la carte Web ou le groupe en cours, vous devez inclure du code dans l'application afin d'extraire l'ID de la carte Web ou du groupe en cours de l'URL. Pour plus d'informations sur les paramètres des cartes Web, reportez-vous à la rubrique Utilisation de paramètres URL.
Vous pouvez par exemple afficher la carte Web Fond de carte de l'Europe dans le modèle Visionneuse de base.
Pour ce faire, commencez avec l'URL de la visionneuse de base :
http://www.arcgis.com/apps/OnePane/basicviewer/index.html
Copiez la partie webmap= de l'URL du fond de carte de l'Europe :
http://www.arcgis.com/home/webmap/viewer.html?webmap=5421a40574914458892efe74f0149025
Ajoutez-la ensuite à la fin de l'URL de la visionneuse de base :
http://www.arcgis.com/apps/OnePane/basicviewer/index.html?webmap=5421a40574914458892efe74f0149025
L'API JavaScript comporte une méthode d'assistance esri.urlToObject qui simplifie ce processus. Cette méthode convertit les paramètres URL en un objet.
var webmap;
var urlObject = esri.urlToObject(document.location.href);
Une fois les paramètres URL convertis en un objet, vous pouvez accéder aux différentes entrées. Vous pouvez par exemple attribuer la valeur du paramètre URL de la carte Web à une variable nommée webmap_id.
var webmap_id = urlObject.query.webmap;
Remarque :Si l'application est configurable, vous devez gérer un paramètre URL appelé appid qui définit les paramètres de configuration. Pour plus d'informations, reportez-vous à la rubrique Création d'un modèle configurable.
Cartes Web
Les modèles de cartes Web sont conçus pour fonctionner avec la carte Web actuellement affichée dans la visionneuse de carte ArcGIS.com. Pour plus d'informations sur la création d'applications cartographiques Web, reportez-vous à la rubrique Création d'applications avec des cartes Web .
Les modèles créent généralement une carte en fonction de la carte Web spécifiée dans le paramètre URL de la carte Web. Chacune des API Web possède une méthode d'assistance qui crée une carte à l'aide des informations issues de l'ID de la carte Web.
Vous pouvez par exemple utiliser la méthode esri.arcgis.utils.createMap d'ArcGIS API for JavaScript pour créer une carte en fonction de l'ID en entrée. Vous pouvez également inclure une fonction de rappel qui s'exécute lorsque la requête synchrone sur esri.arcgis.utils.createMap est terminée.
esri.arcgis.utils.createMap(webmap,"map",{
mapOptions:{
slider:false
},
bingMapsKey:bingMapsKey
}).then(function(response){
map = response.map;
});
Si certaines de vos cartes Web incluent un fond de carte Bing Maps, vous devez indiquer une clé Bing Maps avec la méthode createMap. Vous pouvez également spécifier plusieurs autres options cartographiques, telles qu'indiquer si vous souhaitez afficher le curseur, la navigation, l'attribution, etc.
La fonction de rappel callback permet d'accéder à un objet de réponse qui fournit l'accès à l'objet de carte, aux couches, etc.
Pour en savoir plus sur l'utilisation d'ArcGIS API for Javascript afin d'utiliser les cartes Web
Groupe
Les modèles de groupes affichent le contenu provenant du groupe spécifié sous forme d'une application. Pour plus d'informations sur la création d'applications de bibliothèques, reportez-vous à la rubrique Création d'applications avec des groupes .
L'API Portal for ArcGIS permet d'accéder au contenu d'ArcGIS Online. Vous pouvez l'utiliser pour extraire le contenu du groupe en fonction de l'ID de groupe en entrée. Pour plus d'informations sur l'utilisation de l'API Portal for ArcGIS, reportez-vous à la rubrique A propos de l'API Portal for ArcGIS.
Dans cet exemple, vous interrogez ArcGIS Online pour trouver un groupe avec l'ID en entrée.
var portal = new esri.arcgis.Portal('http://www.arcgis.com');
dojo.connect(portal, 'onLoad',function(){
portal.queryGroup(groupid).then(function(response){
var group = response.results[0];
});
});
Une fois le groupe trouvé, vous pouvez demander à extraire les éléments du groupe.
Dans cet exemple, vous interrogez le groupe pour trouver cinq éléments de type Carte Web ou Application cartographique Web.
var queryParams = {
q: 'type:"Web Map" -type:"Web Mapping Application"',
num: 5
};
group.queryItems(queryParams).then(function(response){
var groupItems = response.results;
});
Autres éléments à prendre en compte
Les modèles étant généralement conçus pour fonctionner avec de nombreux types de contenu différents, vous devrez peut-être paramétrer le modèle pour gérer les cartes comportant des fonds de carte Bing Maps, du contenu non public, etc. Vous trouverez ci-dessous des remarques spécifiques.
Clé Bing Maps
Si certaines des cartes Web que vous souhaitez afficher utilisent un fond de carte Bing Maps, vous devez inclure une clé Bing Maps dans votre application. La clé Bing Maps est fournie sous forme d'option de la méthode createMap.
Gestionnaire d'identité
Le gestionnaire d'identité simplifie l'utilisation des ressources sécurisées. Il gère les processus suivants : demande des informations d'identification de l'utilisateur, génération d'un jeton et ajout du jeton à la ressource. En incluant la classe du gestionnaire d'identité dans votre application de modèle, le modèle fonctionnera avec les cartes Web privées et publiques.
Incluez la ligne de code suivante dans votre application pour activer le gestionnaire d'identité :
dojo.require("esri.IdentityManager");
Pour en savoir plus sur le gestionnaire d'identité
Remarque :Vous devez également configurer SSL sur le serveur Web qui héberge votre application.
Prise en charge proxy et CORS
Comme votre application va effectuer des requêtes inter-domaines destinées à ArcGIS Online, vous devez activer CORS (Cross-Origin Resource Sharing) ou ajouter un proxy à votre application.
Ajout du modèle à ArcGIS Online
Une fois que vous avez créé le modèle et l'avez hébergé sur votre serveur Web, ajoutez-le à ArcGIS Online en tant qu'élément d'application cartographique Web configurable. Sélectionnez le type d'élément Cartographie Web. Choisissez Configurable comme fonction. Pour plus d'informations sur l'ajout d'éléments dans ArcGIS Online, reportez-vous à la rubrique Ajout d'applications. Vous pouvez également ajouter l'élément via l'API Portal for ArcGIS.
N'oubliez pas d'inclure un titre descriptif et un résumé, car ces informations s'affichent lorsque les utilisateurs placent le curseur de la souris sur l'élément de modèle dans la bibliothèque des modèles. Vous pouvez également créer un fichier ZIP contenant les fichiers de votre application et l'associer à l'élément pour permettre de la télécharger.
Utilisation du modèle dans la bibliothèque de votre organisation
Si vous souhaitez utiliser le modèle dans la bibliothèque des modèles cartographiques Web ou dans la bibliothèque des modèles de groupes de votre organisation, partagez l'élément avec le groupe utilisé pour les modèles. L'administrateur de votre organisation pourra ensuite configurer la carte ou configurer les groupes de façon à utiliser le groupe qui comprend votre modèle.