/tags/v5.8-aspergeraie/services/modules/0.1/osm/ZoneAdmin.php |
---|
New file |
0,0 → 1,156 |
<?php |
// declare(encoding='UTF-8'); |
/** |
* Classe permettant d'obtenir le nom et les codes d'une zone administrative à partir de ces coordonnées (latitude et longitude). |
* La latitude et longitude doivent être exprimée par un nombre décimal. |
* Ce service fonctionne uniquement pour les zones administratives dont les contours ont été tracés dans OpenStreetMap. |
* Source des données : OpenStreetMap <http://wiki.openstreetmap.org> |
* Tag:boundary=administrative : <http://wiki.openstreetmap.org/wiki/Tag:boundary%3Dadministrative> |
* Paramètres du service : |
* - lat : latitude |
* - lon : longitude |
* Exemple : |
* http://localhost/service-test:eflore:0.1/osm/nom-commune?lon=3.83619&lat=44.74231 |
* |
* @category php 5.2 |
* @package eFlore |
* @subpackage Services |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
* @author Mohcen BENMOUNAH <mohcen@tela-botanica.org> |
* @copyright Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org) |
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
* @license GNU-GPL <http://www.gnu.org/licenses/gpl.html> |
*/ |
class ZoneADmin { |
const PATTERN_LAT = '/^[0-9]+(?:[.][0-9]+|)$/'; |
const PATTERN_LON = '/^[-]?[0-9]+(?:[.][0-9]+|)$/'; |
const MIME_JSON = 'application/json'; |
private $parametres = array(); |
private $bdd = null; |
private $lat = null; |
private $lon = null; |
private $zone = null; |
public function __construct(Bdd $bdd) { |
$this->bdd = $bdd; |
} |
public function consulter($ressources, $parametres) { |
$this->parametres = $parametres; |
$this->verifierParametres(); |
$this->lat = $this->parametres['lat']; |
$this->lon = $this->parametres['lon']; |
$this->zone = isset($this->parametres['zone']) ? $this->parametres['zone'] : null; |
$zoneTrouveeInfos = $this->localiserPointLatLon(); |
$corps = $this->formaterResultats($zoneTrouveeInfos); |
$resultat = new ResultatService(); |
$resultat->mime = self::MIME_JSON; |
$resultat->corps = $corps; |
return $resultat; |
} |
private function verifierParametres() { |
extract($this->parametres); |
$messages = array(); |
if (! array_key_exists('lat', $this->parametres)) { |
$messages[] = "Vous devez indiquer une latitude en degré décimal à l'aide du paramètres d'url : lat"; |
} else if (!preg_match(self::PATTERN_LAT, $lat)) { |
$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"; |
} |
if (! array_key_exists('lon', $this->parametres)) { |
$messages[] = "Vous devez indiquer une longitude en degré décimal à l'aide du paramètres d'url : lon"; |
} else if (!preg_match(self::PATTERN_LON, $lon)) { |
$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"; |
} |
if (count($messages) != 0) { |
$message = implode('<br />', $messages); |
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE; |
throw new Exception($message, $code); |
} |
} |
private function formaterResultats($zonesTrouveesInfos) { |
$retour = array(); |
foreach ($zonesTrouveesInfos as $infos) { |
$donnees = array(); |
foreach ($infos as $champ => $valeur) { |
if ($valeur != '' && $champ != 'niveau') { |
if ($champ == 'wikipedia') { |
$valeur = $this->formaterUrlWikipedia($valeur); |
} |
$donnees[$champ] = $valeur; |
} |
} |
$retour[$infos['niveau']] = $donnees; |
} |
ksort($retour); |
return $retour; |
} |
private function localiserPointLatLon() { |
$osmIdsInClause = $this->getOsmIdsDesCentresAProximites(); |
$zone = isset($this->zone) ? $this->bdd->proteger($this->zone) : null; |
$requete = 'SELECT id_zone_geo AS codeZoneGeo, intitule, code_iso_3166_1 AS codeIso31661, '. |
'code_iso_3166_2 AS codeIso31662, code_insee AS codeInsee, code_nuts as codeNuts, '. |
'nom_en AS nomEn, nom_es AS nomEs, wikipedia, niveau '. |
'FROM osm_zones_admin '. |
"WHERE st_within(GEOMFROMTEXT('POINT($this->lon $this->lat)'), polygone) = 1 ". |
(isset($zone) ? "AND zone = $zone " : ''). |
"AND osm_id IN ($osmIdsInClause) ". |
' -- '.__FILE__.' : '.__LINE__; |
$resultat = $this->bdd->recupererTous($requete); |
if ($resultat === false) { |
$msgTpl = "Service '%s' : aucune zone correspondant aux coordonnées : %s, %s."; |
$msg = sprintf($msgTpl, get_class($this), $this->lat, $this->lon); |
throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE); |
} |
return $resultat; |
} |
private function getOsmIdsDesCentresAProximites() { |
$requete = $this->construireRequeteUnion(); |
$resultats = $this->bdd->recupererTous($requete); |
if ($resultats === false) { |
$msgTpl = "Service '%s' : aucun centroïde correspondant aux coordonnées : %s, %s."; |
$msg = sprintf($msgTpl, get_class($this), $this->lat, $this->lon); |
throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE); |
} |
$osmIds = array(); |
foreach ($resultats as $info) { |
$osmIds[] = $info['osm_id']; |
} |
$osmIdsInClause = implode(',', $this->bdd->proteger($osmIds)); |
return $osmIdsInClause; |
} |
private function construireRequeteUnion() { |
$zone = isset($this->zone) ? $this->bdd->proteger($this->zone) : null; |
$requeteTpl = 'SELECT osm_id, '. |
"(($this->lon - centre_lng) * ($this->lon -centre_lng) + ($this->lat - centre_lat) * ($this->lat - centre_lat)) AS distance ". |
'FROM osm_zones_admin '. |
'WHERE niveau = %s '. |
(isset($zone) ? "AND zone = $zone " : ''). |
'ORDER BY distance ASC '. |
"LIMIT %s "; |
$niveaux = array(2,3,4,5,6,7,8); |
$requetesAUnir = array(); |
foreach ($niveaux as $niveau) { |
$requetesAUnir[] = sprintf($requeteTpl, $niveau, ($niveau * 2)); |
} |
$requete = '('.implode(') UNION (', $requetesAUnir).') -- '.__FILE__.' : '.__LINE__; |
return $requete; |
} |
private function formaterUrlWikipedia($infoWikipedia) { |
list($lang, $page) = explode(':', $infoWikipedia); |
$pageEncode = rawurlencode($page); |
$urlTpl = 'https://%s.wikipedia.org/wiki/%s'; |
return sprintf($urlTpl, $lang, $pageEncode); |
} |
} |
Property changes: |
Added: svn:mergeinfo |
Merged /branches/v5.2-alpage/services/modules/0.1/osm/ZoneAdmin.php:r976,978 |
Merged /branches/v5.7-arrayanal/services/modules/0.1/osm/ZoneAdmin.php:r1050,1052,1064 |
Merged /branches/v5.1-acheb/services/modules/0.1/osm/ZoneAdmin.php:r927 |
/tags/v5.8-aspergeraie/services/modules/0.1/osm/NomCommune.php |
---|
New file |
0,0 → 1,145 |
<?php |
// declare(encoding='UTF-8'); |
/** |
* Classe permettant d'obtenir le nom et le code INSEE d'une commune à partir de ces coordonnées (latitude et longitude). |
* La latitude et longitude doivent être exprimée par un nombre décimal. |
* Ce service fonctionne uniquement pour les communes de France métropolitaine (Corse comprise) dont les contours ont été tracés dans OpenStreetMap. |
* Source des données : OpenStreetMap http://wiki.openstreetmap.org |
* Projet France limites administratives : http://wiki.openstreetmap.org/wiki/WikiProject_France/Limites_administratives |
* Paramètres du service : |
* - lat : latitude |
* - lon : longitude |
* Exemple : |
* http://localhost/service-test:eflore:0.1/osm/nom-commune?lon=3.83619&lat=44.74231 |
* |
* @category php 5.2 |
* @package carto-osm |
* @author Mohcen BENMOUNAH <mohcen@tela-botanica.org> |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
* @copyright Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org) |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL |
* @version $Id$ |
*/ |
class NomCommune { |
const PATTERN_LAT = '/^[0-9]+(?:[.][0-9]+|)$/'; |
const PATTERN_LON = '/^[-]?[0-9]+(?:[.][0-9]+|)$/'; |
const LAT_MAX = 51.071667; |
const LAT_MIN = 41.316667; |
const LON_MAX = 9.513333; |
const LON_MIN = -5.140278; |
const MIME_JSON = 'application/json'; |
private $parametres = array(); |
private $bdd = null; |
private $lat = null; |
private $lon = null; |
public function __construct(Bdd $bdd) { |
$this->bdd = $bdd; |
} |
public function consulter($ressources, $parametres) { |
$this->parametres = $parametres; |
$this->verifierParametres(); |
$this->lat = $this->parametres['lat']; |
$this->lon = $this->parametres['lon']; |
$communesProches = $this->trouverCommunesProches(); |
$communeTrouveeInfos = $this->localiserPointLatLon($communesProches); |
$corps = $this->formaterResultats($communeTrouveeInfos); |
$resultat = new ResultatService(); |
$resultat->mime = self::MIME_JSON; |
$resultat->corps = $corps; |
return $resultat; |
} |
private function verifierParametres() { |
extract($this->parametres); |
$messages = array(); |
if (! array_key_exists('lat', $this->parametres)) { |
$messages[] = "Vous devez indiquer une latitude en degré décimal à l'aide du paramètres d'url : lat"; |
} else if (!preg_match(self::PATTERN_LAT, $lat)) { |
$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"; |
} else if ($lat > self::LAT_MAX) { |
$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."; |
} else if ($lat < self::LAT_MIN) { |
$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."; |
} |
if (! array_key_exists('lon', $this->parametres)) { |
$messages[] = "Vous devez indiquer une longitude en degré décimal à l'aide du paramètres d'url : lon"; |
} else if (!preg_match(self::PATTERN_LON, $lon)) { |
$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"; |
} else if ($lon > self::LON_MAX) { |
$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."; |
} else if ($lon < self::LON_MIN) { |
$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."; |
} |
if (count($messages) != 0) { |
$message = implode('<br />', $messages); |
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE; |
throw new Exception($message, $code); |
} |
} |
/** |
* requête qui récupère les 20 communes les plus proches du point recherché |
* La distance(AB = \sqrt{(x_B-x_A)^2 + (y_B-y_A)^2}) est calculée sans la racine |
* (calcul en plus qui change pas le résultat). La distance n'est donc pas juste mais permet de récupérer |
* le bon ordre. |
*/ |
private function trouverCommunesProches() { |
$requete = 'SELECT id_osm, '. |
"(({$this->lon} - X(centre)) * ({$this->lon} -X(centre)) + ({$this->lat} - Y(centre)) * ({$this->lat} - Y(centre))) AS distance ". |
'FROM osm_communes '. |
'ORDER BY distance ASC '. |
'LIMIT 20 '. |
' -- '.__FILE__.' : '.__LINE__; |
$resultat = $this->bdd->recupererTous($requete); |
if ($resultat == false) { |
$msgTpl = "Service '%s' : aucune commune dont le centroïde correspond aux coordonnées : %s, %s."; |
$msg = sprintf($msgTpl, get_class($this), $this->lat, $this->lon); |
throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE); |
} |
return $resultat; |
} |
private function formaterResultats($communeTrouveeInfos) { |
return array( |
'nom' => $communeTrouveeInfos['nom'], |
'codeINSEE' => $communeTrouveeInfos['code_insee'], |
'wikipedia' => $this->formaterUrlWikipedia($communeTrouveeInfos['wikipedia']) |
); |
} |
private function localiserPointLatLon($communesProches) { |
$zonesIds = array(); |
foreach ($communesProches as $commune) { |
$zonesIds[] = $commune['id_osm']; |
} |
$idsOsmClauseIn = implode(',', $this->bdd->proteger($zonesIds)); |
$requete = "SELECT id_osm, code_insee, nom, wikipedia ". |
'FROM osm_communes '. |
"WHERE st_within(GEOMFROMTEXT('POINT($this->lon $this->lat)'), polygone) = 1 ". |
"AND id_osm IN ($idsOsmClauseIn) ". |
' -- '.__FILE__.' : '.__LINE__; |
$resultat = $this->bdd->recuperer($requete); |
if ($resultat === false) { |
$msgTpl = "Service '%s' : aucune commune correspondant aux coordonnées : %s, %s."; |
$msg = sprintf($msgTpl, get_class($this), $this->lat, $this->lon); |
throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE); |
} |
return $resultat; |
} |
private function formaterUrlWikipedia($infoWikipedia) { |
list($lang, $page) = explode(':', $infoWikipedia); |
$pageEncode = rawurlencode($page); |
$urlTpl = 'https://%s.wikipedia.org/wiki/%s'; |
return sprintf($urlTpl, $lang, $pageEncode); |
} |
} |