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:
Le code pour les Termes génériques est une valeur comprise entre 1 et 9999. Il y a plus de 1200 Termes génériques. La liste officielle et actuelle est disponible en format XML ici:
Le regroupement des Termes génériques par Catégorie d'entités est disponible en format XML ici:
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.