├── GMaps.php
├── README
└── example.php


/GMaps.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * GMaps class ver 0.2
  4 |  * 
  5 |  * Gets geo-informations from the Google Maps API
  6 |  * http://code.google.com/apis/maps/index.html
  7 |  *
  8 |  * Copyright 2008-2009 by Enrico Zimuel (enrico@zimuel.it)
  9 |  * 
 10 |  */
 11 | class GMaps
 12 | {
 13 |     const MAPS_HOST = 'maps.google.com';
 14 |     /**
 15 |      * Latitude 
 16 |      * 
 17 |      * @var double
 18 |      */
 19 |     private $_latitude;
 20 |     /**
 21 |      * Longitude 
 22 |      *
 23 |      * @var double
 24 |      */
 25 |     private $_longitude;
 26 |     /**
 27 |      * Address 
 28 |      *
 29 |      * @var string
 30 |      */
 31 |     private $_address;
 32 |     /**
 33 |      * Country name 
 34 |      *
 35 |      * @var string
 36 |      */
 37 |     private $_countryName;
 38 |     /**
 39 |      * Country name code
 40 |      *
 41 |      * @var string
 42 |      */
 43 |     private $_countryNameCode;
 44 |     /**
 45 |      * Administrative area name
 46 |      *
 47 |      * @var string
 48 |      */
 49 |     private $_administrativeAreaName;
 50 |     /**
 51 |      * Postal Code
 52 |      *
 53 |      * @var string
 54 |      */
 55 |     private $_postalCode;
 56 |     /**
 57 |      * Google Maps Key
 58 |      *
 59 |      * @var string
 60 |      */
 61 |     private $_key;
 62 |     /**
 63 |      * Base Url
 64 |      *
 65 |      * @var string
 66 |      */
 67 |     private $_baseUrl;
 68 |     /**
 69 |      * Construct
 70 |      *
 71 |      * @param string $key
 72 |      */
 73 |     function __construct ($key='')
 74 |     {
 75 |         $this->_key= $key;
 76 |         $this->_baseUrl= "http://" . self::MAPS_HOST . "/maps/geo?output=xml&key=" . $this->_key;
 77 |     }
 78 |     /**
 79 |      * getInfoLocation
 80 |      *
 81 |      * @param string $address
 82 |      * @param string $city
 83 |      * @param string $state
 84 |      * @return boolean
 85 |      */
 86 |     public function getInfoLocation ($address) {
 87 |         if (!empty($address)) {
 88 |             return $this->_connect($address);
 89 |         }
 90 |         return false;    
 91 |     }
 92 |     /**
 93 |      * connect to Google Maps
 94 |      *
 95 |      * @param string $param
 96 |      * @return boolean
 97 |      */
 98 |     private function _connect($param) {
 99 |         $request_url = $this->_baseUrl . "&oe=utf-8&q=" . urlencode($param);
100 |         $xml = simplexml_load_file($request_url);      
101 |         if (! empty($xml->Response)) {
102 |             $point= $xml->Response->Placemark->Point;
103 |             if (! empty($point)) {
104 |                 $coordinatesSplit = explode(",", $point->coordinates);
105 |                 // Format: Longitude, Latitude, Altitude
106 |                 $this->_latitude = $coordinatesSplit[1];
107 |                 $this->_longitude = $coordinatesSplit[0];    
108 |             }
109 |             $this->_address= $xml->Response->Placemark->address;
110 |             $this->_countryName= $xml->Response->Placemark->AddressDetails->Country->CountryName;
111 |             $this->_countryNameCode= $xml->Response->Placemark->AddressDetails->Country->CountryNameCode;
112 |             $this->_administrativeAreaName= $xml->Response->Placemark->AddressDetails->Country->AdministrativeArea->AdministrativeAreaName;
113 |             $administrativeArea= $xml->Response->Placemark->AddressDetails->Country->AdministrativeArea;
114 |             if (!empty($administrativeArea->SubAdministrativeArea)) {
115 |                 $this->_postalCode= $administrativeArea->SubAdministrativeArea->Locality->PostalCode->PostalCodeNumber;
116 |             } elseif (!empty($administrativeArea->Locality)) {
117 |                 $this->_postalCode= $administrativeArea->Locality->PostalCode->PostalCodeNumber;
118 |             }
119 |             return true;
120 |         } else {
121 |             return false;
122 |         }
123 |     }
124 |     /**
125 |      * get the Postal Code
126 |      *
127 |      * @return string
128 |      */
129 |     public function getPostalCode () {
130 |         return $this->_postalCode;
131 |     }
132 | 	/**
133 |      * get the Address
134 |      *
135 |      * @return string
136 |      */
137 |     public function getAddress () {
138 |         return $this->_address;
139 |     }
140 | 	/**
141 |      * get the Country name
142 |      *
143 |      * @return string
144 |      */
145 |     public function getCountryName () {
146 |         return $this->_countryName;
147 |     }
148 | 	/**
149 |      * get the Country name code
150 |      *
151 |      * @return string
152 |      */
153 |     public function getCountryNameCode () {
154 |         return $this->_countryNameCode;
155 |     }
156 | 	/**
157 |      * get the Administrative area name
158 |      *
159 |      * @return string
160 |      */
161 |     public function getAdministrativeAreaName () {
162 |         return $this->_administrativeAreaName;
163 |     }
164 |     /**
165 |      * get the Latitude coordinate
166 |      *
167 |      * @return double
168 |      */
169 |     public function getLatitude () {
170 |         return $this->_latitude;
171 |     }
172 |     /**
173 |      * get the Longitude coordinate
174 |      *
175 |      * @return double
176 |      */
177 |     public function getLongitude () {
178 |         return $this->_longitude;
179 |     }
180 | }


--------------------------------------------------------------------------------
/README:
--------------------------------------------------------------------------------
1 | A light PHP class that uses the Google Maps API to provide geographic information from a generic address (city, country,street+city, etc).
2 | 
3 | (C) Copyright 2009 Enrico Zimuel
4 | http://www.zimuel.it
5 | 


--------------------------------------------------------------------------------
/example.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | require_once 'GMaps.php';
 3 | 		
 4 | // Your Google key
 5 | $google_key = '';
 6 | 
 7 | if (!empty($_POST)) {
 8 |     $search= strip_tags($_POST['search']);
 9 | }    
10 | 
11 | echo '<form method="post" action="example.php"><input type="text" name="search">';
12 | echo '<input type="submit" value="Get geographic data!"></form>';
13 |     
14 | if (!empty($search)) {
15 | 
16 |     // Get the Google Maps Object
17 |     $GMap = new GMaps($google_key);
18 | 
19 |     if ($GMap->getInfoLocation($search)) {
20 | 
21 |         echo 'Address: '.$GMap->getAddress().'<br>';
22 |         echo 'Country name: '.$GMap->getCountryName().'<br>';
23 |         echo 'Country name code: '.$GMap->getCountryNameCode().'<br>';
24 |         echo 'Administrative area name: '.$GMap->getAdministrativeAreaName().'<br>';
25 |         echo 'Postal code: '.$GMap->getPostalCode().'<br>';    
26 |         echo 'Latitude: '.$GMap->getLatitude().'<br>';
27 |         echo 'Longitude: '.$GMap->getLongitude().'<br>';
28 |         
29 |     } else {
30 |         echo "The response of Google Maps is empty";
31 |     }
32 |     
33 | }


--------------------------------------------------------------------------------