Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 149 | Details | Compare with Previous | 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 
?>