Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 1153 | Rev 1226 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
1056 jpm 1 
<?php
2 
// declare(encoding='UTF-8');
3 
/**
4 
 * Classe permettant d'obtenir le nom et les codes d'une zone administrative à partir de ces coordonnées (latitude et longitude).
5 
 * La latitude et longitude doivent être exprimée par un nombre décimal.
6 
 * Ce service fonctionne uniquement pour les zones administratives dont les contours ont été tracés dans OpenStreetMap.
7 
 * Source des données : OpenStreetMap <http://wiki.openstreetmap.org>
8 
 * Tag:boundary=administrative : <http://wiki.openstreetmap.org/wiki/Tag:boundary%3Dadministrative>
9 
 * Paramètres du service :
10 
 *  - lat : latitude
11 
 *  - lon : longitude
12 
 * Exemple :
13 
 * http://localhost/service-test:eflore:0.1/osm/nom-commune?lon=3.83619&lat=44.74231
14 
 *
15 
 * @category	php 5.2
16 
 * @package		eFlore
17 
 * @subpackage	Services
18 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
19 
 * @author		Mohcen BENMOUNAH <mohcen@tela-botanica.org>
20 
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
21 
 * @license		CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt>
22 
 * @license		GNU-GPL <http://www.gnu.org/licenses/gpl.html>
23 
 */
24 
class ZoneADmin {
25 
 
1141 aurelien 26 
	const PATTERN_LAT = '/^[-]?[0-9]+(?:[.][0-9]+|)$/';
1056 jpm 27 
	const PATTERN_LON = '/^[-]?[0-9]+(?:[.][0-9]+|)$/';
28 
	const MIME_JSON = 'application/json';
29 
 
30 
	private $parametres = array();
31 
	private $bdd = null;
32 
 
33 
	private $lat = null;
34 
	private $lon = null;
1072 jpm 35 
	private $zone = null;
1141 aurelien 36 
	private $niveaux = null;
1151 aurelien 37 
	private $pays = null;
1143 aurelien 38 
 
39 
	private $masque = null;
1149 aurelien 40 
	private $limite = 1;
1056 jpm 41 
 
42 
	public function __construct(Bdd $bdd) {
43 
		$this->bdd = $bdd;
44 
	}
45 
 
46 
	public function consulter($ressources, $parametres) {
47 
		$this->parametres = $parametres;
48 
		$this->verifierParametres();
1143 aurelien 49 
		$this->masque = isset($this->parametres['masque']) ? $this->parametres['masque'] : null;
1149 aurelien 50 
		$this->limite = isset($this->parametres['limite']) ? intval($this->parametres['limite']) : $this->limite;
1143 aurelien 51 
		$this->lat = isset($this->parametres['lat']) ? $this->parametres['lat'] : null;
52 
		$this->lon = isset($this->parametres['lon']) ? $this->parametres['lon'] : null;
1072 jpm 53 
		$this->zone = isset($this->parametres['zone']) ? $this->parametres['zone'] : null;
1141 aurelien 54 
		$this->niveaux = isset($this->parametres['niveau']) ? explode(',', $this->parametres['niveau']) : null;
1151 aurelien 55 
		$this->pays = isset($this->parametres['pays']) ? $this->parametres['pays'] : null;
1143 aurelien 56 
 
57 
		if($this->masque != null) {
1151 aurelien 58 
			$corps = $this->rechercherZoneGeoParNom($this->masque, $this->niveaux, $this->limite, $this->pays);
1143 aurelien 59 
		} else {
60 
			$zoneTrouveeInfos = $this->localiserPointLatLon();
61 
			$corps = $this->formaterResultats($zoneTrouveeInfos);
62 
		}
1056 jpm 63 
 
64 
		$resultat = new ResultatService();
65 
		$resultat->mime = self::MIME_JSON;
66 
		$resultat->corps = $corps;
67 
		return $resultat;
68 
	}
69 
 
70 
	private function verifierParametres() {
71 
		extract($this->parametres);
72 
		$messages = array();
1143 aurelien 73 
 
74 
		if(array_key_exists('masque', $this->parametres)) {
75 
			if (empty($masque)) {
76 
				$messages[] = "S'il est présent le paramètre recherche ne peut pas être vide";
77 
			}
78 
		} else {
79 
			if (! array_key_exists('lat', $this->parametres)) {
80 
				$messages[] = "Vous devez indiquer une latitude en degré décimal à l'aide du paramètres d'url : lat";
81 
			} else if (!preg_match(self::PATTERN_LAT, $lat)) {
82 
				$messages[] = "La valeur de latitude doit être un nombre décimal dont le séparateur décimal est un point. Ex. : 44 ou 43.03";
83 
			}
84 
			if (! array_key_exists('lon', $this->parametres)) {
85 
				$messages[] = "Vous devez indiquer une longitude en degré décimal à l'aide du paramètres d'url : lon";
86 
			} else if (!preg_match(self::PATTERN_LON, $lon)) {
87 
				$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";
88 
			}
1056 jpm 89 
		}
90 
		if (count($messages) != 0) {
91 
			$message = implode('<br />', $messages);
92 
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
93 
			throw new Exception($message, $code);
94 
		}
95 
	}
96 
 
97 
	private function formaterResultats($zonesTrouveesInfos) {
98 
		$retour = array();
99 
		foreach ($zonesTrouveesInfos as $infos) {
100 
			$donnees = array();
101 
			foreach ($infos as $champ => $valeur) {
102 
				if ($valeur != '' && $champ != 'niveau') {
103 
					if ($champ == 'wikipedia') {
104 
						$valeur = $this->formaterUrlWikipedia($valeur);
105 
					}
106 
					$donnees[$champ] = $valeur;
107 
				}
108 
			}
109 
			$retour[$infos['niveau']] = $donnees;
110 
		}
111 
		ksort($retour);
112 
		return $retour;
113 
	}
114 
 
115 
	private function localiserPointLatLon() {
116 
		$osmIdsInClause = $this->getOsmIdsDesCentresAProximites();
1072 jpm 117 
		$zone = isset($this->zone) ? $this->bdd->proteger($this->zone) : null;
1056 jpm 118 
 
119 
		$requete = 'SELECT id_zone_geo AS codeZoneGeo, intitule, code_iso_3166_1 AS codeIso31661, '.
120 
			'code_iso_3166_2 AS codeIso31662, code_insee AS codeInsee, code_nuts as codeNuts, '.
121 
			'nom_en AS nomEn, nom_es AS nomEs, wikipedia, niveau '.
122 
			'FROM osm_zones_admin '.
123 
			"WHERE st_within(GEOMFROMTEXT('POINT($this->lon $this->lat)'), polygone) = 1 ".
1072 jpm 124 
			(isset($zone) ? "AND zone = $zone " : '').
1056 jpm 125 
			"AND osm_id IN ($osmIdsInClause) ".
126 
			' -- '.__FILE__.' : '.__LINE__;
1151 aurelien 127 
 
1056 jpm 128 
		$resultat = $this->bdd->recupererTous($requete);
129 
		if ($resultat === false) {
130 
			$msgTpl = "Service '%s' : aucune zone correspondant aux coordonnées : %s, %s.";
131 
			$msg = sprintf($msgTpl, get_class($this), $this->lat, $this->lon);
132 
			throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
133 
		}
134 
		return $resultat;
135 
	}
136 
 
137 
	private function getOsmIdsDesCentresAProximites() {
138 
		$requete = $this->construireRequeteUnion();
139 
		$resultats = $this->bdd->recupererTous($requete);
140 
		if ($resultats === false) {
141 
			$msgTpl = "Service '%s' : aucun centroïde correspondant aux coordonnées : %s, %s.";
142 
			$msg = sprintf($msgTpl, get_class($this), $this->lat, $this->lon);
143 
			throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
144 
		}
145 
		$osmIds = array();
146 
		foreach ($resultats as $info) {
147 
			$osmIds[] = $info['osm_id'];
148 
		}
149 
		$osmIdsInClause = implode(',', $this->bdd->proteger($osmIds));
150 
		return $osmIdsInClause;
151 
	}
152 
 
153 
	private function construireRequeteUnion() {
1072 jpm 154 
		$zone = isset($this->zone) ? $this->bdd->proteger($this->zone) : null;
1141 aurelien 155 
		$niveaux = isset($this->niveaux) ? $this->niveaux : null;
156 
 
1056 jpm 157 
		$requeteTpl = 'SELECT osm_id, '.
1065 jpm 158 
			"(($this->lon - centre_lng) * ($this->lon -centre_lng) + ($this->lat - centre_lat) * ($this->lat - centre_lat)) AS distance ".
1056 jpm 159 
			'FROM osm_zones_admin '.
160 
			'WHERE niveau = %s '.
1072 jpm 161 
			(isset($zone) ? "AND zone = $zone " : '').
1056 jpm 162 
			'ORDER BY distance ASC '.
163 
			"LIMIT %s ";
1141 aurelien 164 
		$niveaux = isset($niveaux) ? $niveaux : array(2,3,4,5,6,7,8);
1056 jpm 165 
		$requetesAUnir = array();
166 
		foreach ($niveaux as $niveau) {
1141 aurelien 167 
			$requetesAUnir[] = sprintf($requeteTpl, $this->bdd->proteger($niveau), ($niveau * 2));
1056 jpm 168 
		}
169 
		$requete = '('.implode(') UNION (', $requetesAUnir).') -- '.__FILE__.' : '.__LINE__;
170 
		return $requete;
171 
	}
172 
 
173 
	private function formaterUrlWikipedia($infoWikipedia) {
174 
		list($lang, $page) = explode(':', $infoWikipedia);
175 
		$pageEncode = rawurlencode($page);
176 
		$urlTpl = 'https://%s.wikipedia.org/wiki/%s';
177 
		return sprintf($urlTpl, $lang, $pageEncode);
178 
	}
1143 aurelien 179 
 
1151 aurelien 180 
	public function rechercherZoneGeoParNom($masque, $niveaux = null, $limite = 1, $pays = null) {
1143 aurelien 181 
		$masque_fmt = str_replace(array(' ', '-'), '_', $masque);
1149 aurelien 182 
		// Cas d'une recherche pour autocompletion
183 
		$masque_fmt = ($limite > 1) ? $masque_fmt.'%' : $masque_fmt;
1143 aurelien 184 
 
185 
		$champs = 'id_zone_geo, osm_id, intitule, centre_lat, centre_lng, '.
1151 aurelien 186 
					'zone, niveau, code_iso_3166_1 AS codeIso31661, code_iso_3166_2 AS codeIso31662, code_insee, '.
1143 aurelien 187 
					'nom, nom_fr, nom_en, nom_es, wikipedia';
188 
 
1149 aurelien 189 
		$champs_tri = 'IF(ISNULL(nom_fr), 0, 1) as nom_fr_present, '.
190 
				'IF(ISNULL(nom_en), 0, 1) as nom_en_present, '.
191 
				'IF(ISNULL(nom_es), 0, 1) as nom_es_present, '.
192 
				'IF(ISNULL(intitule), 0, 1) as intitule_present, '.
1153 aurelien 193 
				'IF(ISNULL(nom), 0, 1) as nom_present, '.
194 
				'IF(zone = "north-america", 0, 1) as hors_amerique_du_nord ';
1149 aurelien 195 
 
1153 aurelien 196 
		// les US ont beaucoup de villes qui possèdent des noms similaires
197 
		// à des villes européennes, ce qui entraine beaucoup de résultats vers les US
198 
		// au lieu de la ville originelle, on les "déclasse" donc artificiellement
199 
		$ordre = 'hors_amerique_du_nord DESC, niveau DESC, nom_present DESC, nom_fr_present DESC, nom_fr_present DESC, '.
200 
				 'nom_es_present DESC, intitule_present DESC';
1149 aurelien 201 
 
1151 aurelien 202 
		$niveau_str = array();
203 
		if($niveaux != null) {
204 
			foreach ($niveaux as $niveau) {
205 
				$niveau_str[] = $this->bdd->proteger($niveau);
206 
			}
1149 aurelien 207 
		}
208 
 
1151 aurelien 209 
		$pays_str = '';
210 
		if($pays != null) {
211 
			$pays_str = '(code_iso_3166_1 = '.$this->bdd->proteger($pays).' OR  '.
212 
			'code_iso_3166_2 LIKE '.$this->bdd->proteger($pays."%").')';
213 
		}
214 
 
1149 aurelien 215 
		$requete = "SELECT $champs, $champs_tri FROM osm_zones_admin ".
216 
					"WHERE ".
217 
						(!empty($niveau_str) ? ("niveau IN (".implode(',', $niveau_str).") AND ") : "").
1151 aurelien 218 
						(!empty($pays_str) ? $pays_str.' AND ' : "").
1149 aurelien 219 
						"(nom LIKE ".$this->bdd->proteger($masque_fmt).' OR '.
220 
						"intitule LIKE ".$this->bdd->proteger($masque_fmt).' OR '.
221 
						"nom_fr LIKE ".$this->bdd->proteger($masque_fmt).' OR '.
222 
						"nom_en LIKE ".$this->bdd->proteger($masque_fmt).' OR '.
1152 aurelien 223 
						"nom_es LIKE ".$this->bdd->proteger($masque_fmt).') '.
1151 aurelien 224 
			"ORDER BY ".$ordre." LIMIT ".$limite;
1143 aurelien 225 
 
226 
		$resultat = $this->bdd->recupererTous($requete);
227 
		if (empty($resultat)) {
228 
			$msgTpl = "Service '%s' : aucune zone correspondant au nom : %s .";
229 
			$msg = sprintf($msgTpl, get_class($this), $masque);
230 
			throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
1149 aurelien 231 
		} else {
232 
			$resultat = ($limite == 1) ? $resultat[0] : $resultat;
1143 aurelien 233 
		}
234 
 
1149 aurelien 235 
		return $resultat;
1143 aurelien 236 
	}
1056 jpm 237 
}