Identification des couches

Nom harmonisé des couches

Les couches principales sont identifiées par les codes suivants :

Code Nom
ADDRESSES.CROSSINGS Adresses début-fin sur les tronçons de route
ADMINISTRATIVEUNITS.BOUNDARIES Limites administratives
BUILDINGS.BUILDINGS Constructions
CADASTRALPARCELS.PARCELS Parcelles cadastrales
ELEVATION.SLOPES MNT sous forme d'une image en teintes hypsométriques
GEOGRAPHICALGRIDSYSTEMS.MAPS Cartes scannées, quelque soit leur échelle (hors INSPIRE)
GEOGRAPHICALNAMES.NAMES Noms de lieux
HYDROGRAPHY.HYDROGRAPHY Réseaux hydrographiques
ORTHOIMAGERY.ORTHOPHOTOS Ortho-photographies, quelque soit leur résolution
ELEVATION.LEVEL0 Traits de côte
TOPONYMS.ALL Toponymes
TRANSPORTNETWORKS.RAILWAYS Réseaux ferroviaires
TRANSPORTNETWORKS.ROADS Réseaux routiers
TRANSPORTNETWORKS.RUNWAYS Pistes d'aéroports, d'aérodromes
UTILITYANDGOVERNMENTALSERVICES.ALL Ouvrages et constructions gouvernementales

Ces codes sont basés sur la directive Européenne INSPIRE, annexes I à III à partir des noms des thèmes. Dans le cadre de l'application de la directive, les services fourniront les noms harmonisés prévus par INSPIRE. L'objectif est d'avoir des noms homogènes dans toute l'Europe pour faciliter la mise en place des services d'accès aux données géographiques.

Les codes sont ajoutés/mis à jour avec les mises-à-jour de l'infrastructure Géoportail. Pour rester informé sur les codes, il faut récupérer les capacités des services ad hoc (e.g., les capacités du WMS-C sont là, et les capacités du WMS sont là). Ces codes sont préfixés par le code du territoire dans le cas des services WMS.

D'autres codes apparaîtront dans les mois à venir.

Types de services

L'API permet ou permettra d'accéder aux types de services suivants :

Type Service d'accès URLs des services
WMSC WMS-C WMS tuilé du Géoportail  
service de consultation INSPIRE  
WMS tuilé du pour le Ministère de l'Education Nationale
WMS WMS 1.1.1 WMS du Géoportail  
service de consultation INSPIRE
WMS WMS 1.3.0 WMS du Géoportail  
service de consultation INSPIRE
WFS WFS 1.0.0 N/A
WFS WFS 1.1.0 N/A
WFS WFS 2.0.0 N/A
OLS OLS 1.0.0 service de recherche par adresse  
service de recherche par nom

API Web 2D en Javascript

Ces codes sont véhiculés par la clef de licence. En fonction du contrat, ils peuvent donc ne pas tous être disponibles. Ils peuvent être retrouvés via le tableau instance.allowedGeoportalLayers dans l'API Javascript. L'extrait de code ci-dessous montre comment afficher les cartes sans transparence et ne pas afficher les ortho-photographies :

if (maCarte.getMap().allowedGeoportalLayers) {
    for (var i= 0; i<maCarte.getMap().allowedGeoportalLayers.length; i++) {
        var overloaded_options= null;
        var couche= maCarte.getMap().allowedGeoportalLayers[i];
        if (couche.match(/^GEOGRAPHICALGRIDSYSTEMS.MAPS/)) {// maps
            overloaded_options= {
                                    opacity: 1.0
            };
        } else if (couche.match(/^ORTHOIMAGERY.ORTHOPHOTOS/)) {// orthophotos
            overloaded_options= {
                                    visibility: false
            };
        }
        maCarte.addGeoportalLayer(couche,overloaded_options);
    }
}

Se reporter à la documentation Javascript Catalogue.js pour trouver les valeurs par défaut de la transparence et de la visibilité des couches.

À partir de la version 1.0beta4, les noms standards des couches sont suffixés par ':' concaténé au type du service donnant accès à la couche.

Échelles et niveaux de zoom

L'API supporte 21 niveaux de zoom. Les niveaux de zoom sont utilisés par l'API via les méthodes setCenter*(). Le tableau ci-dessous indique pour les niveaux de zooms actifs la correspondance avec les échelles :

Zoom Échelle Projection de la carte
0 Monde IGNF:MILLER
1 Monde IGNF:MILLER
2 Monde IGNF:MILLER
3 Monde IGNF:MILLER
4 Monde IGNF:MILLER
5 État IGNF:GEOPORTAL*
6 État IGNF:GEOPORTAL*
7 État IGNF:GEOPORTAL*
8 Département IGNF:GEOPORTAL*
9 Département IGNF:GEOPORTAL*
10 Département IGNF:GEOPORTAL*
11 Département IGNF:GEOPORTAL*
12 Ville IGNF:GEOPORTAL*
13 Ville IGNF:GEOPORTAL*
14 Ville IGNF:GEOPORTAL*
15 Ville IGNF:GEOPORTAL*
16 Rue IGNF:GEOPORTAL*
17 Rue IGNF:GEOPORTAL*
18 Rue IGNF:GEOPORTAL*
19 Rue IGNF:GEOPORTAL*
20 Maison IGNF:GEOPORTAL*

Les projections IGNF:GEOPORTAL* sont compatibles avec les projections plate-carré. L'API Géoportail étire/compresse les images pour faire la superposition (extension d'OpenLayers par IGNF). Des codes EPSG non officiels peuvent être aussi utilisé en lieu et place des codes IGNF, voir là.

Attribution des propriétaires des données :

Pour toute couche qui peut être ajouter à la carte, l'API expose un mécanisme pour informer de l'origine des données. Si OpenLayers utilise le paramètre attribution, l'API utilise un tableau de distributeurs avec les propriétés suivantes pour chacun des distributeurs :

  • logo : une chaîne de caractères identifiant le logo du distributeur. Cf. pictureUrl pour de plus amples informations ;
  • pictureUrl : si définie, c'est l'URL de l'image. Si non définie, la propriété logo est utilisée pour construire l'URL de l'image comme suit : http://www.geoportail.fr/legendes/logo_ + logo + .gif ;
  • url : l'URL du distributeur. La page web sera ouverte dans une nouvelle fenêtre ;
  • extent : emprise d'application des données ;
  • attribution : texte court relatif aux propriétaires des données.