Service d'information sur les codes

Le Service d'information sur les codes fournit la définition des codes et des abréviations utilisés par les Services Web. Il permet également à vos applications de valider les paramètres et les codes avant d'envoyer une requête aux Services Web (par exemple, à l'API et au WFS).

Le service consiste à utiliser l'URI suivant:

http://geonames.nrcan.gc.ca/codeinfoservice/services?request=Requête&code=Code&language=Language

Les valeurs valides pour la "Requête" sont indiquées dans le tableau ci-dessous:

Requête Paramètres Réponse URL
getCapabilities Aucun Liste des requêtes disponibles ...Capabilities
getFeatureTypeDescription code, language response=Masse de neige et de glace éternelles (glacier, icefield, ice cap / icecap) ...request=getFeature...
getFeatureTypeTerm code, language response=Autre zone municipale / de district - agglomération majeure ...request=getFeature...
getGenericCodeDescription code, language response=Lieu habité non constituée. ...request=getGeneric...
getGenericTerm code, language response=Hameau ...request=getGeneric...
getStatusCodeDescription code, language response=Toponyme sanctionné par le membre du CPCNG. ...request=getStatus...
getStatusTerm code, language response=Officiel ...request=getStatus...
validateConciseCode code response=true ...request=validateCon...
validateGenericCode code response=false ...request=validateGen...
validateMap mapNumber response=true ...request=validateMap...
validateStatusCode code response=true ...request=validateSta...

Autres exemples:

http://geonames.nrcan.gc.ca/codeinfoservice/services?request=validateMap&mapNumber=011P16

http://geonames.nrcan.gc.ca/codeinfoservice/services?request=getGenericTerm&code=111&language=fr

Les codes pour Language sont "en" ou "fr".

Les codes des Types d'entité géographique (également connu sous le nom Catégories d'entité ou Codes concis) sont les suivants:

AIR, BAY, BCH, CAMP, CAPE, CAVE, CHAN, CITY, CLF, CRAT, DMUN, FALL, FOR, GEOG, GLAC, HAM, HYDR, IR, ISL, LAKE, MAR, MIL, MISC, MTN, MUN1, MUN2, PARK, PLN, PROV, RAIL, RAP, RECR, RES, RIV, RIVF, ROAD, SEA, SEAF, SEAU, SHL, SITE, SPRG, TERR, TOWN, UNP, VALL, VEGL, VILG.

La liste officielle et actuelle est disponible en format XML ici:

http://geonames.nrcan.gc.ca/wfs/cubeserv.cgi?service=wfs&datastore=cgns&typename=cgns_codes &request=getFeature &filter=<Filter><PropertyIsEqualTo> <PropertyName>COLUMN_NAME</PropertyName> <Literal>CONCISE_CODE</Literal></PropertyIsEqualTo></Filter>

Le code pour les Termes génériques est une valeur comprise entre 1 et 9 999. Il y a plus de 1 200 Termes génériques. La liste officielle et actuelle est disponible en format XML ici:

http://geonames.nrcan.gc.ca/wfs/cubeserv.cgi?service=wfs&datastore=cgns&typename=cgns_codes &request=getFeature &filter=<Filter><PropertyIsEqualTo> <PropertyName>COLUMN_NAME</PropertyName> <Literal>GENERIC_CODE</Literal></PropertyIsEqualTo></Filter>

 

Le regroupement des Termes génériques par Catégorie d'entités est disponible en format XML ici:

http://geonames.nrcan.gc.ca/wfs/cubeserv.cgi?service=wfs&datastore=cgns&typename=generic_codes &request=getFeature

Les codes de statut sont les suivants:

A1, A10, A11, A12, A13, A2, A21, A3, A4, A5, A6, A7, A8, A9, A99, B1, B10, B11, B12, B13, B14, B15, B2, B3, B4, B5, B6, B9, C1, C10, C11, C2, C3, C4, C5, C7, C9, D10, D35, D46, D47, D48, D59, D60, D61, D62, E1, E10, E2, E3, E4, E5, E6, E7, G1, M1, M2, P1, Q1, Q2, S1, S2, S3, T1, U1, U2, U3, W1, Y1.

Le mapNumber est le numéro d'une carte géographique dans le système national de référence cartographique (SNRC) à l'échelle 1:50 000. C'est une valeur alphanumérique sous la forme nnnAnn, par exemple, 032B04.