« LINUX:API de géolocalisation » : différence entre les versions
Aucun résumé des modifications |
Aucun résumé des modifications |
||
| Ligne 2 : | Ligne 2 : | ||
=But= | =But= | ||
Nous allons décrire ici l'utilisation de ce programme. | Nous allons décrire ici l'utilisation de ce programme. | ||
Cet API recherche les rues, les communes et leurs coordonnées géographiques répondant à divers critères. | Cet API recherche les rues, les communes et leurs coordonnées géographiques répondant à divers critères. Il permet d'afficher la liste des pays concernés et d'effectuer des recherches sur les départements (FR) et les provinces (BE). | ||
| Ligne 36 : | Ligne 36 : | ||
=Utilisation= | =Utilisation= | ||
Le script a besoin de divers paramètres: | Diverses recherches sont possibles: | ||
* "type": type de recherche. | * La rue (street) | ||
* La commune (city) | |||
* Le département (FR) ou la province (BE) (department) | |||
* Le pays (country) | |||
Entre parenthèses, vous trouvez le mot clé à utiliser pour l'argument "type". | |||
Les résultats retournés sont sous forme d'une liste, limitée à 20 par défaut. Par défaut, une sortie au format JSON est fournie mais une sortie brute au format HTML est possible dans un but de vérification plus facile. | |||
Le script a besoin de divers paramètres; tous ne sont pas tous nécessaires ou sont optionnels en fonction du type de recherche: | |||
* "type": type de recherche. Quatre valeurs sont possible comme décrite ci-dessus: street, city, department et country. Le type "street" est utilisé par défaut. | |||
* "trace": si une valeur quelconque est fournie, une sortie brute HTML remplace la sortie au format JSON. | |||
* "maximumResponses": nombre maximum de résultats. Il est limité à 50 et par défaut, il vaut 20. | * "maximumResponses": nombre maximum de résultats. Il est limité à 50 et par défaut, il vaut 20. | ||
* "terr": restriction de la recherche à un/des pays et/ou à un/des départements. Le format répond au canevas suivant: <nowiki><code du pays> <code du département>;<code du pays> <code du département>;...</nowiki> Il est conseillé de fournir au moins un code de pays ou un code de département sinon la recherche prend plus de temps. Si plusieurs départements/pays sont requis, ils sont séparés par un point virgule (";"). Exemples: | * "terr": permet de préciser le pays et/ou le département de recherche et dépend de la variable 'type" (voir détails). | ||
* "text": comprend la partie concernant la recherche; il reprend pour partie, le champs à rechercher et dépend de la variable 'type" (voir détails). | |||
restriction de la recherche à un/des pays et/ou à un/des départements. Le format répond au canevas suivant: <nowiki><code du pays> <code du département>;<code du pays> <code du département>;...</nowiki> Il est conseillé de fournir au moins un code de pays ou un code de département sinon la recherche prend plus de temps. Si plusieurs départements/pays sont requis, ils sont séparés par un point virgule (";"). Exemples: | |||
FR 75;BE 90000 (pour le département de Paris et la province de Namur) | FR 75;BE 90000 (pour le département de Paris et la province de Namur) | ||
29 (pour le département du Finistère) | 29 (pour le département du Finistère) | ||