Les données géochronologiques contenues dans la Base canadienne de connaissances géochronologiques sont accessibles par l'intermédiaire des services Web (XML). Cette page décrit les services disponibles, indique où on peut les trouver et propose des façons d'extraire les données au moyen d'un programme.
La base de données contient les tables suivantes :
Ces tables sont combinées dans un fichier plat (en deux dimensions) ; les services interrogent cette vue pour obtenir de l'information. Vous pouvez obtenir les données d'une seule table à la fois, ou toutes les données dans la vue simultanément. Les données peuvent être filtrées pour obtenir uniquement les résultats correspondant :
Prenez note que vous devez également spécifier des paramètres
pour certaines méthodes de service, en procédant tel que décrit
à la page suivante. Enfin, vous pouvez obtenir les résultats
en langage de balisage extensible (XML) ou en format délimité
par des virgules.
La liste des services Web apparaît ci-dessous. L'adresse des services qui renvoient des données en format XML est différente de ceux qui renvoient les données en format délimité par des virgules. Dans chaque table, vous pouvez obtenir le nom de la méthode de service désirée, en repérant l'intersection du nom de la table de données et du filtre particulier concerné.
Services qui retournent les données en format XML
Les méthodes se trouvent à l'endroit suivant http://gdr.ess.nrcan.gc.ca/ geochron/web_services/TableAsXML.asmx
| XML | non filtré | par Province |
|---|---|---|
| tous les tables | allAsXML | allAsXMLByProv |
| Rockfile | rockfileAsXML | rockfileAsXMLByProv |
| Refs | refsAsXML | refsAsXMLByProv |
| RockRef | rockrefAsXML | rockrefAsXMLByProv |
| GSC_Age | gsc_ageAsXML | gsc_ageAsXMLByProv |
| XML | par Project | par SNRC |
| tous les tables | allAsXMLbyProj | allAsXMLbyNTS |
| Rockfile | rockfileAsXMLbyProj | rockfileAsXMLbyNTS |
| Refs | refsAsXMLbyProj | refsAsXMLbyNTS |
| RockRef | rockrefAsXMLbyProj | rockrefAsXMLbyNTS |
| GSC_Age | gsc_ageAsXMLbyProj | gsc_ageAsXMLbyNTS |
Services qui retournent les données en format délimité par des virgules
Les méthodes se trouvent à l'endroit suivant http://gdr.ess.nrcan.gc.ca/ geochron/web_services/TableAsCSV.asmx
| CSV | non filtré | par Province |
|---|---|---|
| tous les tables | allAsCSV | allAsCSVByProv |
| Rockfile | rockfileAsCSV | rockfileAsCSVByProv |
| Refs | refsAsCSV | refsAsCSVByProv |
| RockRef | rockrefAsCSV | rockrefAsCSVByProv |
| GSC_Age | gsc_ageAsCSV | gsc_ageAsCSVByProv |
| CSV | par Project | par SNRC |
| tous les tables | allAsCSVbyProj | allAsCSVbyNTS |
| Rockfile | rockfileAsCSVbyProj | rockfileAsCSVbyNTS |
| Refs | refsAsCSVbyProj | refsAsCSVbyNTS |
| RockRef | rockrefAsCSVByProj | rockrefAsCSVByNTS |
| GSC_Age | gsc_ageAsCSVByProj | gsc_ageAsCSVByNTS |
Les paramètres requis par certaines méthodes sont indiqués ci-dessous. Un message d'erreur s'affiche si le paramètre approprié (par exemple, un code de province valide dans le cas des méthodes « ...ByProv ») n'est pas fourni.
| paramètre | description | valeurs |
|---|---|---|
| pr | abbreviation de deux lettres de la province ou du territoire | AB, BC, MB, NB, NF, NS, NU, NT, ON, PE, QC, SK, YT |
| project | nom du projet | Churchill 1999, Churchill-Y12, Grenville 2003, Yukon 2002 |
| nts | Système national de référence cartographique | e.g. 64 or 64A or 64A04 |
La façon d'obtenir des données au moyen de ces services est décrite brièvement sur la page suivante.
Description de base
Les services Web sont analogues aux autres fonctions ou méthodes disponibles dans un environnement de programmation. Le développeur doit connaître :
En général, un service Web décrit tous ces renseignements au moyen d'un document WSDL (Web Services Description Language ou langage de description de services Web). C'est un document XML, parfois appelé le « contrat » : le service traite les données et renvoie un message contenant les paramètres appropriés par l'intermédiaire du protocole SOAP (Simple Object Access Protocol).
La plupart des informations relatives à ces services Web de géochronologie sont fournis sur la page précédente. Pour toutes les méthodes indiquées, le résultat se présente sous forme d'une « chaîne », telle que définie dans l'environnement .NET de Microsoft. Ce type de données est facilement reconnu par la plupart des langages de programmation et de script ou peut être facilement converti.
Veuillez noter que les résultats peuvent être très volumineux et nécessiter par conséquent un traitement spécial ou une extension de la capacité de mémoire, selon l'environnement de programmation.