Subversion Repositories eFlore/Projets.eflore-projets

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
149 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
 * Classe permettant d'obtenir le nom et le code INSEE des communes les plus proches d'un point (latitude et longitude).
5
 * La latitude et longitude doivent être exprimée par un nombre décimal.
6
 * Ce service fonctionne uniquement sur les communes de France métropolitaine (Corse comprise) présentent
7
 * dans les données Lion1906 téléchargeable à cette adrese : http://www.lion1906.com/Pages/francais/utile/telechargements.html.
8
 * Source des données : Lion1906.com http://www.lion1906.com
9
 * Paramètres du service :
10
 *  - lat : latitude
11
 *  - lon : longitude
12
 * Exemple :
13
 * http://localhost/lion1906/services/0.1/nom-commune?lat=44.71546&lon=3.84216
14
 *
15
 * @category	php 5.2
16
 * @package		lion1906
17
 * @author		Mohcen BENMOUNAH <mohcen@tela-botanica.org>
18
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
19
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
20
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
21
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
22
 * @version		$Id$
23
 */
24
class NomCommune {
25
 
26
	const PATTERN_LAT = '/^[0-9]+(?:[.][0-9]+|)$/';
27
	const PATTERN_LON = '/^[-]?[0-9]+(?:[.][0-9]+|)$/';
28
	const LAT_MAX = 51.071667;
29
	const LAT_MIN = 41.316667;
30
	const LON_MAX = 9.513333;
31
	const LON_MIN = -5.140278;
32
	const NBRE_COMMUNE_PAR_DEFAUT = 10;
33
	const NBRE_COMMUNE_MAX = 100;
34
	const MIME_JSON = 'application/json';
35
 
36
	private $parametres = array();
37
	private $ressources = array();
38
	private $bdd = null;
39
 
40
	public function __construct(Bdd $bdd) {
41
		$this->bdd = $bdd;
42
	}
43
 
44
	public function consulter($ressources, $parametres) {
45
		$this->parametres = $parametres;
46
		$this->ressources = $ressources;
47
 
48
		$this->definirParametresParDefaut();
49
		$this->verifierParametres();
50
 
51
		$nomINSEEs = $this->trouverCommunesProches();
52
		$corps = $this->formaterResultats($nomINSEEs);
53
 
54
		$resultat = new ResultatService();
55
		$resultat->mime = self::MIME_JSON;
56
		$resultat->corps = $corps;
57
		return $resultat;
58
	}
59
 
60
	private function definirParametresParDefaut() {
61
		if (array_key_exists('nbre', $this->parametres) === false) {
62
			$this->parametres['nbre'] = self::NBRE_COMMUNE_PAR_DEFAUT;
63
		}
64
	}
65
 
66
	private function verifierParametres() {
67
		extract($this->parametres);
68
		$messages = array();
69
		if (! array_key_exists('lat', $this->parametres)) {
70
			$messages[] = "Vous devez indiquer une latitude en degré décimal à l'aide du paramètres d'url : lat";
71
		} else if (!preg_match(self::PATTERN_LAT, $lat)) {
72
			$messages[] = "La valeur de latitude doit être un nombre décimal positif dont le séparateur décimal est un point. Ex. : 44 ou 43.03";
73
		} else if ($lat > self::LAT_MAX) {
74
			$messages[] = "La valeur de latitude indiquée est supérieure à {self::LAT_MAX} qui est le point le plus au Nord de la France métropolitaine.";
75
		} else if ($lat < self::LAT_MIN) {
76
			$messages[] = "La valeur de latitude indiquée est infèrieure à {self::LAT_MIN} qui est le point le plus au Sud de la France métropolitaine.";
77
		}
78
		if (! array_key_exists('lon', $this->parametres)) {
79
			$messages[] = "Vous devez indiquer une longitude en degré décimal à l'aide du paramètres d'url : lon";
80
		} else if (!preg_match(self::PATTERN_LON, $lon)) {
81
			$messages[] = "La valeur de longitude doit être un nombre décimal dont le séparateur décimal est un point. Ex. : -4.03 ou 3.256";
82
		} else if ($lon > self::LON_MAX) {
83
			$messages[] = "La valeur de longitude indiquée est supérieure à {self::LON_MAX} qui est le point le plus à l'Est de la France métropolitaine.";
84
		} else if ($lon < self::LON_MIN) {
85
			$messages[] = "La valeur de longitude indiquée est infèrieure à {self::LON_MIN} qui est le point le plus à l'Ouest de la France métropolitaine.";
86
		}
87
		if (array_key_exists('nbre', $this->parametres)) {
88
			if (!preg_match('/^[0-9]+$/', $nbre)) {
89
				$messages[] = "Le nombre de commune le plus proche à retourner doit être un entier positif. Ex. : 10";
90
			} else if ($nbre > self::NBRE_COMMUNE_MAX) {
91
				$messages[] = "Le nombre de commune le plus proche à retourner doit être un entier positif inférieur à 100. Ex. : 10";
92
			}
93
		}
94
 
95
		if (count($messages) != 0) {
96
			$message = implode('<br />', $messages);
97
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
98
			throw new Exception($message, $code);
99
		}
100
	}
101
 
102
	private function formaterResultats($nomINSEEs) {
103
		$communes_trouvees = null;
104
		if (isset($nomINSEEs) && !empty($nomINSEEs)) {
105
			foreach ($nomINSEEs as $nomINSEE) {
106
				$communes_trouvees[] = array('nom' => $nomINSEE['nom'], 'codeINSEE' => $nomINSEE['insee']);
107
			}
108
			if (!is_null($communes_trouvees)) {
109
				if ($this->parametres['nbre'] == 1 && count($communes_trouvees) == 1) {
110
					$communes_trouvees = $communes_trouvees[0];
111
				}
112
			} else {
113
				$message = "Le service '".get_class($this)."' n'a trouvé aucune commune correspondant aux coordonnées : {$parametres['lat']}, {$parametres['lon']}.";
114
				$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
115
				throw new Exception($message, $code);
116
			}
117
		} else {
118
			$message = "Le service '".get_class($this)."' n'a trouvé aucune commune dont le centroïde correspond aux coordonnées : {$parametres['lat']}, {$parametres['lon']}.";
119
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
120
			throw new Exception($message, $code);
121
		}
122
		return $communes_trouvees;
123
	}
124
 
125
	/**
126
	 * requête qui récupère les 20 communes les plus proches du point recherché
127
	 * La distance(AB = \sqrt{(x_B-x_A)^2 + (y_B-y_A)^2}) est calculée sans la racine
128
	 * (calcul en plus qui change pas le résultat).
129
	*/
130
	private function trouverCommunesProches() {
131
		$lat = $this->parametres['lat'];
132
		$lon = $this->parametres['lon'];
133
		$requete =	'SELECT '.
134
			"	(({$lat} - X(centroide)) * ({$lat} - X(centroide)) + ({$lon} - Y(centroide)) * ({$lon} - Y(centroide))) AS distance, ".
135
			"insee, nom ".
136
			'FROM lion1906_communes_v2008 '.
137
			'ORDER BY distance '.
138
			"LIMIT {$this->parametres['nbre']} ";
139
		$resultat = $this->bdd->recupererTous($requete);
140
		return $resultat;
141
	}
142
}
143
?>