Service liste pays

## **Service de liste**
### **Pays**

#### *Requête*

|**Méthode**|**Requête**|**Description**|
| :- | :- | :- |
|GET|/pays|Récupérer les informations concernant les pays|
#### *Paramètres*

|**Paramètres**|**Description**|**Type**|
| :- | :- | :- |
|date|La requête renvoie tous les pays actifs à la date donnée. Par défaut, c’est la date courante.|Date|
#### *Exemples de requête*
/geo/pays

/geo/pays?date=1950-01-01
#### *Champs de la réponse*

|**Champ**|**Description**|
| :- | :- |
|URI|URI du pays|
|Type|« Pays »|
|Code|Code Insee du pays|
|Intitule|Nom du pays|
|IntituleEntier|Nom du pays en forme longue|
|Iso3166alpha2|Code ISO 3166-1 alpha-2 du pays|
|Iso3166alpha3|Code ISO 3166-1 alpha-3 du pays|
|Iso3166num|Code ISO 3166-1 numérique du pays|
|DateCreation|Date de création du pays|
|DateSuppression|Date de suppression du pays s’il a été supprimé|
#### *Exemple de réponse en XML*
```xml

France
République française
FR
FRA
250
1943-01-01


Danemark
Royaume du Danemark
DK
DNK
208
1943-01-01

...

Palaos
République des Palaos
PW
PLW
585
1994-10-01

```
#### *Exemple de réponse en JSON*
```json
[
{
"type": "Pays",
"code": "99100",
"uri": "http://id.insee.fr/geo/pays/b7e3f0c9-b653-4a3e-904a-de63b80e108b",
"intitule": "France",
"IntituleEntier": "République française",
"Iso3166alpha2": "FR",
"Iso3166alpha": "FRA",
"Iso3166num": "250",
"dateCreation": "1943-01-01"
},
{
"type": "Pays",
"code": "99101",
"uri": "http://id.insee.fr/geo/pays/2ece43e9-b813-4e66-8285-807065c7c618",
"intitule": "Danemark",
"IntituleEntier": "Royaume du Danemark",
"Iso3166alpha2": "DK",
"Iso3166alpha": "DNK",
"Iso3166num": "208",
"dateCreation": "1943-01-01"
},
...
{
"type": "Pays",
"code": "99517",
"uri": "http://id.insee.fr/geo/pays/baa15226-ddd9-41be-a6f1-cbec54cdefe4",
"intitule": "Palaos",
"IntituleEntier": "République des Palaos",
"Iso3166alpha2": "PW",
"Iso3166alpha": "PLW",
"Iso3166num": "585",
"dateCreation": "1994-10-01"
}
]
```
#### *Exemple de requête SPARQL*
```sparql
PREFIX igeo:
PREFIX xsd:
SELECT DISTINCT ?uri ?type ?code ?nom ?nomLong ?iso3166alpha2 ?iso3166alpha3 ?iso3166num ?dateCreation ?dateSuppression
WHERE {
?s a igeo:Pays ;
a ?typeRDF ;
igeo:codeINSEE ?code ;
igeo:nom ?nom .
OPTIONAL {?s igeo:nomLong ?nomLong .}
OPTIONAL {?s igeo:codeIso3166alpha2 ?iso3166alpha2 .}
OPTIONAL {?s igeo:codeIso3166alpha3 ?iso3166alpha3 .}
OPTIONAL {?s igeo:codeIso3166num ?iso3166num .}
BIND(STR(?typeRDF) AS ?type).
BIND(STR(?s) AS ?uri).
OPTIONAL {?s ^igeo:creation/igeo:date ?dateCreation }
OPTIONAL {?s ^igeo:suppression/igeo:date ?dateSuppression }
FILTER (!BOUND(?dateCreation) || ?dateCreation <= NOW() )
FILTER (!BOUND(?dateSuppression) || ?dateSuppression > NOW() )
}
ORDER BY ?code
```
Avec le paramètre date :
```sparql
PREFIX igeo:
PREFIX xsd:
SELECT DISTINCT ?uri ?type ?code ?nom ?nomLong ?iso3166alpha2 ?iso3166alpha3 ?iso3166num ?dateCreation ?dateSuppression
WHERE {
?s a igeo:Pays ;
a ?typeRDF ;
igeo:codeINSEE ?code ;
igeo:nom ?nom .
OPTIONAL {?s igeo:nomLong ?nomLong .}
OPTIONAL {?s igeo:codeIso3166alpha2 ?iso3166alpha2 .}
OPTIONAL {?s igeo:codeIso3166alpha3 ?iso3166alpha3 .}
OPTIONAL {?s igeo:codeIso3166num ?iso3166num .}
BIND(STR(?typeRDF) AS ?type).
BIND(STR(?s) AS ?uri).
OPTIONAL {?s ^igeo:creation/igeo:date ?dateCreation }
OPTIONAL {?s ^igeo:suppression/igeo:date ?dateSuppression }
FILTER(!BOUND(?dateCreation) || ?dateCreation <= '1950-01-01'^^xsd:date)
FILTER(!BOUND(?dateSuppression) || ?dateSuppression > '1950-01-01'^^xsd:date)
}
ORDER BY ?code
```