Technical documentation of Geoportal API

  • FR
  • UK

Index / Documentation / Technical documentation

Geoportal layers

Resources harmonized name 
Services types 
Geoportal resolutions 
API territories

Resources harmonized name

The main layers are identified by the following codes :

  • Geoportal Tiled Service (http://wxs.ign.fr/geoportail/wmts) :
    CodeNom
    ADMINISTRATIVEUNITS.BOUNDARIESLimites administratives
    AREAMANAGEMENT.ZFUZones franches urbaines
    AREAMANAGEMENT.ZUSZones urbaines sensibles
    BUILDINGS.BUILDINGSBâtiments
    CADASTRALPARCELS.PARCELSParcelles cadastrales
    ELEVATION.ELEVATIONGRIDCOVERAGEMNT BDAlti V1
    ELEVATION.LEVEL0Trait de côte Histolitt
    ELEVATION.SLOPESCarte du relief
    ELEVATION.SLOPES.HIGHRESLitto3D ®
    GEOGRAPHICALGRIDSYSTEMS.1900TYPEMAPSCarte topographique - environs de Paris (1906)
    GEOGRAPHICALGRIDSYSTEMS.ADMINISTRATIVEUNITSFrance administrative
    GEOGRAPHICALGRIDSYSTEMS.BONNEGuyane française (1780)
    GEOGRAPHICALGRIDSYSTEMS.CASSINICarte de Cassini (XVIIIe siècle)
    GEOGRAPHICALGRIDSYSTEMS.COASTALMAPSCarte littorale (SHOM/IGN)
    GEOGRAPHICALGRIDSYSTEMS.ETATMAJOR10Carte de l'état-major - environs de Paris (1818 - 1824)
    GEOGRAPHICALGRIDSYSTEMS.ETATMAJOR40Carte de l'état-major (1820-1866)
    GEOGRAPHICALGRIDSYSTEMS.FRANCERASTERCarte France Raster ®
    GEOGRAPHICALGRIDSYSTEMS.LE-HAVRE1975Cartographie Le Havre 1975
    GEOGRAPHICALGRIDSYSTEMS.LE-HAVRE1979Cartographie Le Havre 1979
    GEOGRAPHICALGRIDSYSTEMS.MAPSCartes IGN
    GEOGRAPHICALGRIDSYSTEMS.MAPS.OVERVIEWCarte Mondiale pour la mini-vue
    GEOGRAPHICALGRIDSYSTEMS.MAPS.SCAN-EXPRESS.CLASSIQUEPYRAMIDE SCAN EXPRESS CLASSIQUE
    GEOGRAPHICALGRIDSYSTEMS.MAPS.SCAN-EXPRESS.STANDARDPYRAMIDE SCAN EXPRESS STANDARD
    GEOGRAPHICALGRIDSYSTEMS.MAPS.SCAN-OACIcarte OACI-VFR 2014
    GEOGRAPHICALGRIDSYSTEMS.PLANIGNPlan IGN
    GEOGRAPHICALNAMES.NAMESDénominations géographiques
    HABITATSANSBIOTOPES.ZICOZones d'importance pour la conservation des oiseaux
    HYDROGRAPHY.HYDROGRAPHYHydrographie
    LANDCOVER.CORINELANDCOVERCorine Land Cover 2006
    LANDCOVER.FORESTAREASRégions forestières nationales
    LANDCOVER.FORESTCOVERForêt
    LANDCOVER.FORESTINVENTORY.V1Carte forestière v1 (1987-2004)
    LANDCOVER.FORESTINVENTORY.V2Carte forestière (v2 : 2006-)
    LANDCOVER.SYLVOECOREGIONSSylvoécorégions
    LANDCOVER.SYLVOECOREGIONS.ALLUVIUMSylvoécorégions d'alluvions récentes
    LANDUSE.AGRICULTURE2007Registre parcellaire graphique (RPG) 2007
    LANDUSE.AGRICULTURE2008Registre parcellaire graphique (RPG) 2008
    LANDUSE.AGRICULTURE2009Registre parcellaire graphique (RPG) 2009
    LANDUSE.AGRICULTURE2010Registre parcellaire graphique (RPG) 2010
    LANDUSE.AGRICULTURE2011Registre parcellaire graphique (RPG) 2011
    LANDUSE.AGRICULTURE2012Registre parcellaire graphique (RPG) 2012
  • Geoportal WMS raster service (http://wxs.ign.fr/geoportail/r/wms) :
    CodeNom
    ELEVATION.ELEVATIONGRIDCOVERAGEMNT BDAlti V1
    GEOGRAPHICALGRIDSYSTEMS.CASSINICarte de Cassini (XVIIIe siècle)
    GEOGRAPHICALGRIDSYSTEMS.ETATMAJOR10Carte de l'état-major - environs de Paris (1818 - 1824)
    GEOGRAPHICALGRIDSYSTEMS.ETATMAJOR40Carte de l'état-major (1820-1866)
    GEOGRAPHICALGRIDSYSTEMS.MAPSCartes IGN
    GEOGRAPHICALGRIDSYSTEMS.MAPS.SCAN-EXPRESS.CLASSIQUEPYRAMIDE SCAN EXPRESS CLASSIQUE
    GEOGRAPHICALGRIDSYSTEMS.MAPS.SCAN-EXPRESS.STANDARDPYRAMIDE SCAN EXPRESS STANDARD
    GEOGRAPHICALGRIDSYSTEMS.PLANIGNPlan IGN
    HR.ORTHOIMAGERY.ORTHOPHOTOSBDORTHOHR WM - 057 2012
    LANDUSE.AGRICULTURE2007Registre parcellaire graphique (RPG) 2007
    LANDUSE.AGRICULTURE2008Registre parcellaire graphique (RPG) 2008
    LANDUSE.AGRICULTURE2009Registre parcellaire graphique (RPG) 2009
    LANDUSE.AGRICULTURE2010Registre parcellaire graphique (RPG) 2010
    LANDUSE.AGRICULTURE2011Registre parcellaire graphique (RPG) 2011
    LANDUSE.AGRICULTURE2012Registre parcellaire graphique (RPG) 2012
    ORTHOIMAGERY.ORTHOPHOTOSPhotographies aériennes
    ORTHOIMAGERY.ORTHOPHOTOS.BDORTHOBDORTHO WM - D057 2012
    ORTHOIMAGERY.ORTHOPHOTOS.PARISParis haute résolution
  • Geoportal WMS vector service (http://wxs.ign.fr/geoportail/v/wms) :
    Code (ter=Territory, srs=Projection)Nom
    BDADRESSE-POINTADRESSE_BDD_ter_srsBDAdresse Point Adresse
    BDADRESSE-ROUTESADRESSE_BDD_ter_srsBDAdresse Routes Adresse
    BDCARTO-ADMINISTRATIF_ter_srsBDCarto thème ADMINISTRATIF
    BDCARTO-EQUIPEMENT_ter_srsBDCarto thème EQUIPEMENT
    BDCARTO-HABILLAGE_ter_srsBDCarto thème HABILLAGE
    BDCARTO-HYDROGRAPHIE_ter_srsBDCarto thème HYDRAGRAPHIE
    BDCARTO-RESEAU_ROUTIER_ter_srsBDCarto thème RESEAU ROUTIER
    BDGEODESIQUE-RGP_BDD-POI_WLDRéseaux Géodésiques
    BDGEODESIQUE-RN_BDD-POI_WLD
    BDGEODESIQUE-SITE-RBF_BDD-POI_WLD
    BDGEODESIQUE-SITE-RDF_BDD-POI_WLD
    BDGEODESIQUE-TRIPLET_BDD-POI_WLD
    BDPARCELLAIRE-VECTEUR_WLD_BDD_WGS84GBDParcellaire Vecteur
    BDTOPO-ADMINISTRATIF_ter_srsBDTopo Thème Adminstratif
    BDTOPO-BATI_ter_srsBDTopo Thème Bati
    BDTOPO-HYDROGRAPHIE_ter_srsBDTopo Thème Hydrographie
    BDTOPO-OROGRAPHIE_ter_srsBDTopo Thème Orographie
    BDTOPO-RESEAU_ROUTIER_ter_srsBDTopo Thème Réseau Routier
    BDTOPO-TRANSPORT_ENERGIE_ter_srsBDTopo Thème Transport d'énergie
    BDTOPO-TRANSPORT_VOIES_FERREES_ter_srsBDTopo Thème Voies Ferrées
    BDTOPO-VEGETATION_ter_srsBDTopo Thème Végétation
    BDTOPO-ZONE-ACTIVITES_ter_srsBDTopo Thème Zones d'activités
  • INSPIRE WMS raster service (http://wxs.ign.fr/inspire/r/wms) :
    CodeThème INSPIRE
    CP.CadastralParcelI.6. Parcelles cadastrales
    EL.GridCoverageII.1. Altitude
    OI.OrthoimageCoverageII.3. Ortho-imagerie
    OI.OrthoimageCoverage.HRII.3. Ortho-imagerie
  • INSPIRE WMS vector service (http://wxs.ign.fr/inspire/v/wms) :
    CodeThème INSPIRE
    AD.AddressI.5. Adresses
    AU.AdministrativeUnitI.4. Unités administratives
    BU.BuildingIII.2. Bâtiments
    GN.GeographicalNamesI.3. Dénominations géographiques
    HY.PhysicalWatersI.8. Hydrographie
    TN.AirTransportNetworkI.7. Réseaux de transports (Aérien)
    TN.RailTransportNetworkI.7. Réseaux de transports (Ferré)
    TN.RoadTransportNetworkI.7. Réseaux de transports (Routier)
    US.UtilityAndGovernmentalServicesIII.6. Services d'utilité publique et services publics

    Search engine resources are identified by the following codes :

    CodeNom
    StreetAddressStreet adtresses
    PositionOfInterestGeonames
    CadastralParcelCadastral parcel identifiers

    Layer names are added/updated with the Geoportal's updates. To be informed about available layers, one have to get the capabilities of the relevant services (for instance, WMTS capabilities are there, vector WMS capabilities are there and raster WMS capabilities are there).

    These names are transported with the license key. Depending on your license, not all the names are available.

Services types

The API gives or will give access to the following types of services :

TypeAccess serviceServices URL
WMTSWMTS 1.0.0Geoportal's WMTS
WMSWMS 1.1.1N/A
WMSWMS 1.3.0Geoportal's raster WMS  
INSPIRE view service
WMSWMS 1.3.0Geoportal's vector WMS  
INSPIRE view service
WFSWFS 1.0.0N/A
WFSWFS 1.1.0N/A
WFSWFS 2.0.0Geoportal's WFS  
INSPIRE view service
OLSOLS 1.0.0N/A
OLSOLS 1.2.0Geoportal's address location utility service 
Geoportal's geoname location utility service  
Geoportal's cadastral parcel location utility service
WMSCWMS-CN/A

In order to know which data you have access to, you can use this link by replacing YOUR_API_KEY by your API key.

Geoportal resolutions

  • Resolutions and scales in Spherical Web Mercator (EPSG:3857) : Geoportal default reference systeme
    ZoomResolution  (m/px)Geographical  resolution  (deg/px)Aproximate  scale
    0156543.03392804101.406250000000000000001 : 559082264
    178271.51696402050.703125000000000000001 : 279541132
    239135.75848201020.351562500000000000001 : 139770566
    319567.87924100510.175781250000000000001 : 69885283
    49783.93962050260.087890625000000000001 : 34942642
    54891.96981025130.043945312500000000001 : 17471321
    62445.98490512560.021972656250000000001 : 8735660
    71222.99245256280.010986328125000000001 : 4367830
    8611.49622628140.005493164062500000001 : 2183915
    9305.74811314070.002746582031250000001 : 1091958
    10152.87405657040.001373291015625000001 : 545979
    1176.43702828520.000686645507812500001 : 272989
    1238.21851414260.000343322753906250001 : 136495
    1319.10925707130.000171661376953125001 : 68247
    149.55462853560.000085830688476562501 : 34124
    154.77731426780.000042915344238281201 : 17062
    162.38865713390.000021457672119140601 : 8531
    171.19432856700.000010728836059570301 : 4265
    180.59716428350.000005364418029785161 : 2133
    190.29858214170.000002682209014892581 : 1066
    200.14929107090.000001341104507446291 : 533
    210.07464553540.000000670552253723151 : 267
  • Resolutions and scales in Lambert 93 (EPSG:2154)
    ZoomResolution  (m/px)Aproximate  scale
    0104579.22454989401 : 373497230
    152277.53235379051 : 186705472
    226135.48707859541 : 93341025
    313066.89138180001 : 46667469
    46533.22860411351 : 23332959
    53266.55952446271 : 11666284
    61633.26600459741 : 5833093
    7816.62955498601 : 2916534
    8408.31391467681 : 1458263
    9204.15674151091 : 729131
    10102.07831678321 : 364565
    1151.03914489661 : 182283
    1225.51956907431 : 91141
    1312.75978369361 : 45570
    146.37989163601 : 22785
    153.18994576531 : 11393
    161.59497286951 : 5696
    170.79748643151 : 2848
    180.39874321491 : 1424
    190.19937160731 : 712
    200.09968580371 : 356
    210.04984290181 : 178

API territories

The territory code is an extended ISO 3166 alpha-3 string :

  • For the standard ISO 3166 alpha-3 the allowed values are :
    ATFArctic territory (not yet in production)
    FXXFrance mainland
    GLPGuadeloupe
    GUFGuyane
    MTQMartinique
    MYTMayotte
    NCLNew Caledonia
    PYFFrench polynesia
    REUReunion island
    SPMSaint-Pierre-et-Miquelon
    WLFWallis and Futuna
  • The following extra values, extending ISO 3166 alpha-3, have been created for the Geoportal API :
    []
    ANFFrench Antilla (GLP, MTQ, SMA, SBA)
    CRZCrozet islands
    EUEEuropean Union
    KERKerguelen islands
    SBASaint-Barthelemy islands
    SMASaint-Martin islands
    ASPSaint-Paul-Amsterdam islands (not yet in production)
    WLDthe World

    The default value used by the API is "FXX".