include/maps/GoogleMapAPI.class.php

   1 <?php
   2 error_reporting(E_STRICT | E_ALL);
   3
   4 /**
   5  * Project:     GoogleMapAPI: a PHP library inteface to the Google Map API
   6  * File:        GoogleMapAPI.class.php
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2.1 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with this library; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  *
  22  * For questions, help, comments, discussion, etc., please join the
  23  * Smarty mailing list. Send a blank e-mail to
  24  * smarty-general-subscribe@lists.php.net
  25  *
  26  * @link http://www.phpinsider.com/php/code/GoogleMapAPI/
  27  * @copyright 2005 New Digital Group, Inc.
  28  * @author Monte Ohrt <monte at ohrt dot com>
  29  * @package GoogleMapAPI
  30  * @version 2.5
  31  */
  32
  33 /* $Id: GoogleMapAPI.class.php,v 1.63 2007/08/03 16:29:40 mohrt Exp $ */
  34
  35 /*
  36
  37 For best results with GoogleMaps, use XHTML compliant web pages with this header:
  38
  39 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  40 <html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml">
  41
  42 For database caching, you will want to use this schema:
  43
  44 CREATE TABLE GEOCODES (
  45   address varchar(255) NOT NULL default '',
  46   lon float default NULL,
  47   lat float default NULL,
  48   PRIMARY KEY  (address)
  49 );
  50
  51 */
  52
  53 class GoogleMapAPI {
  54
  55     /**
  56      * PEAR::DB DSN for geocode caching. example:
  57      * $dsn = 'mysql://user:pass@localhost/dbname';
  58      *
  59      * @var string
  60      */
  61     var $dsn = null;
  62
  63     /**
  64      * YOUR GooglMap API KEY for your site.
  65      * (http://maps.google.com/apis/maps/signup.html)
  66      *
  67      * @var string
  68      */
  69     var $api_key = '';
  70
  71     /**
  72      * current map id, set when you instantiate
  73      * the GoogleMapAPI object.
  74      *
  75      * @var string
  76      */
  77     var $map_id = null;
  78
  79     /**
  80      * sidebar <div> used along with this map.
  81      *
  82      * @var string
  83      */
  84     var $sidebar_id = NULL;
  85
  86     /**
  87      * GoogleMapAPI uses the Yahoo geocode lookup API.
  88      * This is the application ID for YOUR application.
  89      * This is set upon instantiating the GoogleMapAPI object.
  90      * (http://developer.yahoo.net/faq/index.html#appid)
  91      *
  92      * @var string
  93      */
  94     var $app_id = null;
  95
  96     /**
  97      * use onLoad() to load the map javascript.
  98      * if enabled, be sure to include on your webpage:
  99      * <html onload="onLoad()">
 100      *
 101      * @var string
 102      */
 103     var $onload = true;
 104
 105     /**
 106      * map center latitude (horizontal)
 107      * calculated automatically as markers
 108      * are added to the map.
 109      *
 110      * @var float
 111      */
 112     var $center_lat = null;
 113
 114     /**
 115      * map center longitude (vertical)
 116      * calculated automatically as markers
 117      * are added to the map.
 118      *
 119      * @var float
 120      */
 121     var $center_lon = null;
 122
 123     /**
 124      * enables map controls (zoom/move/center)
 125      *
 126      * @var boolean
 127      */
 128     var $map_controls = true;
 129
 130     /**
 131      * determines the map control type
 132      * small -> show move/center controls
 133      * large -> show move/center/zoom controls
 134      *
 135      * @var string
 136      */
 137     var $control_size = 'large';
 138
 139     /**
 140      * enables map type controls (map/satellite/hybrid)
 141      *
 142      * @var boolean
 143      */
 144     var $type_controls = true;
 145
 146     /**
 147      * default map type (G_NORMAL_MAP/G_SATELLITE_MAP/G_HYBRID_MAP)
 148      *
 149      * @var boolean
 150      */
 151     var $map_type = 'G_NORMAL_MAP';
 152
 153     /**
 154      * enables scale map control
 155      *
 156      * @var boolean
 157      */
 158     var $scale_control = true;
 159
 160         /*
 161                 HACK -> Drag
 162         */
 163         var $disable_drag = false;
 164
 165         /**
 166      * enables overview map control
 167      *
 168      * @var boolean
 169      */
 170     var $overview_control = false;
 171
 172     /**
 173      * determines the default zoom level
 174      *
 175      * @var integer
 176      */
 177     var $zoom = 16;
 178
 179     /**
 180      * determines the map width
 181      *
 182      * @var integer
 183      */
 184     var $width = '500px';
 185
 186     /**
 187      * determines the map height
 188      *
 189      * @var integer
 190      */
 191     var $height = '500px';
 192
 193     /**
 194      * message that pops up when the browser is incompatible with Google Maps.
 195      * set to empty string to disable.
 196      *
 197      * @var integer
 198      */
 199     var $browser_alert = 'Sorry, the Google Maps API is not compatible with this browser.';
 200
 201     /**
 202      * message that appears when javascript is disabled.
 203      * set to empty string to disable.
 204      *
 205      * @var string
 206      */
 207     var $js_alert = '<b>Javascript must be enabled in order to use Google Maps.</b>';
 208
 209     /**
 210      * determines if sidebar is enabled
 211      *
 212      * @var boolean
 213      */
 214     var $sidebar = true;
 215
 216     /**
 217      * determines if to/from directions are included inside info window
 218      *
 219      * @var boolean
 220      */
 221     var $directions = false;
 222
 223     /**
 224      * determines if map markers bring up an info window
 225      *
 226      * @var boolean
 227      */
 228     var $info_window = true;
 229
 230     /**
 231      * determines if info window appears with a click or mouseover
 232      *
 233      * @var string click/mouseover
 234      */
 235     var $window_trigger = 'click';
 236
 237     /**
 238      * what server geocode lookups come from
 239      *
 240      * available: YAHOO  Yahoo! API. US geocode lookups only.
 241      *            GOOGLE Google Maps. This can do international lookups,
 242      *                   but not an official API service so no guarantees.
 243      *            Note: GOOGLE is the default lookup service, please read
 244      *                  the Yahoo! terms of service before using their API.
 245      *
 246      * @var string service name
 247      */
 248     var $lookup_service = 'GOOGLE';
 249         var $lookup_server = array('GOOGLE' => 'maps.google.com', 'YAHOO' => 'api.local.yahoo.com');
 250
 251     /**
 252      * version number
 253      *
 254      * @var string
 255      */
 256     var $_version = '2.5';
 257
 258     /**
 259      * list of added markers
 260      *
 261      * @var array
 262      */
 263     var $_markers = array();
 264
 265     /**
 266      * maximum longitude of all markers
 267      *
 268      * @var float
 269      */
 270     var $_max_lon = -1000000;
 271
 272     /**
 273      * minimum longitude of all markers
 274      *
 275      * @var float
 276      */
 277     var $_min_lon = 1000000;
 278
 279     /**
 280      * max latitude
 281      *
 282      * @var float
 283      */
 284     var $_max_lat = -1000000;
 285
 286     /**
 287      * min latitude
 288      *
 289      * @var float
 290      */
 291     var $_min_lat = 1000000;
 292
 293     /**
 294      * determines if we should zoom to minimum level (above this->zoom value) that will encompass all markers
 295      *
 296      * @var boolean
 297      */
 298     var $zoom_encompass = true;
 299
 300     /**
 301      * factor by which to fudge the boundaries so that when we zoom encompass, the markers aren't too close to the edge
 302      *
 303      * @var float
 304      */
 305     var $bounds_fudge = 0.01;
 306
 307     /**
 308      * use the first suggestion by a google lookup if exact match not found
 309      *
 310      * @var float
 311      */
 312     var $use_suggest = false;
 313
 314
 315     /**
 316      * list of added polylines
 317      *
 318      * @var array
 319      */
 320     var $_polylines = array();
 321
 322     /**
 323      * icon info array
 324      *
 325      * @var array
 326      */
 327     var $_icons = array();
 328
 329     /**
 330      * database cache table name
 331      *
 332      * @var string
 333      */
 334     var $_db_cache_table = 'GEOCODES';
 335
 336
 337     /**
 338      * class constructor
 339      *
 340      * @param string $map_id the id for this map
 341      * @param string $app_id YOUR Yahoo App ID
 342      */
 343     function GoogleMapAPI($map_id = 'map', $app_id = 'MyMapApp') {
 344         $this->map_id = $map_id;
 345         $this->sidebar_id = 'sidebar_' . $map_id;
 346         $this->app_id = $app_id;
 347     }
 348
 349     /**
 350      * sets the PEAR::DB dsn
 351      *
 352      * @param string $dsn
 353      */
 354     function setDSN($dsn) {
 355         $this->dsn = $dsn;
 356     }
 357
 358     /**
 359      * sets YOUR Google Map API key
 360      *
 361      * @param string $key
 362      */
 363     function setAPIKey($key) {
 364         $this->api_key = $key;
 365     }
 366
 367     /**
 368      * sets the width of the map
 369      *
 370      * @param string $width
 371      */
 372     function setWidth($width) {
 373         if(!preg_match('!^(\d+)(.*)$!',$width,$_match))
 374             return false;
 375
 376         $_width = $_match[1];
 377         $_type = $_match[2];
 378         if($_type == '%')
 379             $this->width = $_width . '%';
 380         else
 381             $this->width = $_width . 'px';
 382
 383         return true;
 384     }
 385
 386     /**
 387      * sets the height of the map
 388      *
 389      * @param string $height
 390      */
 391     function setHeight($height) {
 392         if(!preg_match('!^(\d+)(.*)$!',$height,$_match))
 393             return false;
 394
 395         $_height = $_match[1];
 396         $_type = $_match[2];
 397         if($_type == '%')
 398             $this->height = $_height . '%';
 399         else
 400             $this->height = $_height . 'px';
 401
 402         return true;
 403     }
 404
 405     /**
 406      * sets the default map zoom level
 407      *
 408      * @param string $level
 409      */
 410     function setZoomLevel($level) {
 411         $this->zoom = (int) $level;
 412     }
 413
 414     /**
 415      * enables the map controls (zoom/move)
 416      *
 417      */
 418     function enableMapControls() {
 419         $this->map_controls = true;
 420     }
 421
 422     /**
 423      * disables the map controls (zoom/move)
 424      *
 425      */
 426     function disableMapControls() {
 427         $this->map_controls = false;
 428     }
 429
 430     /**
 431      * sets the map control size (large/small)
 432      *
 433      * @param string $size
 434      */
 435     function setControlSize($size) {
 436         if(in_array($size,array('large','small')))
 437             $this->control_size = $size;
 438     }
 439
 440     /**
 441      * enables the type controls (map/satellite/hybrid)
 442      *
 443      */
 444     function enableTypeControls() {
 445         $this->type_controls = true;
 446     }
 447
 448     /**
 449      * disables the type controls (map/satellite/hybrid)
 450      *
 451      */
 452     function disableTypeControls() {
 453         $this->type_controls = false;
 454     }
 455
 456     /**
 457      * set default map type (map/satellite/hybrid)
 458      *
 459      */
 460     function setMapType($type) {
 461         switch($type) {
 462             case 'hybrid':
 463                 $this->map_type = 'G_HYBRID_MAP';
 464                 break;
 465             case 'satellite':
 466                 $this->map_type = 'G_SATELLITE_MAP';
 467                 break;
 468             case 'map':
 469             default:
 470                 $this->map_type = 'G_NORMAL_MAP';
 471                 break;
 472         }
 473     }
 474
 475     /**
 476      * enables onload
 477      *
 478      */
 479     function enableOnLoad() {
 480         $this->onload = true;
 481     }
 482
 483     /**
 484      * disables onload
 485      *
 486      */
 487     function disableOnLoad() {
 488         $this->onload = false;
 489     }
 490
 491     /**
 492      * enables sidebar
 493      *
 494      */
 495     function enableSidebar() {
 496         $this->sidebar = true;
 497     }
 498
 499     /**
 500      * disables sidebar
 501      *
 502      */
 503     function disableSidebar() {
 504         $this->sidebar = false;
 505     }
 506
 507     /**
 508      * enables map directions inside info window
 509      *
 510      */
 511     function enableDirections() {
 512         $this->directions = true;
 513     }
 514
 515     /**
 516      * disables map directions inside info window
 517      *
 518      */
 519     function disableDirections() {
 520         $this->directions = false;
 521     }
 522
 523     /**
 524      * set browser alert message for incompatible browsers
 525      *
 526      * @params $message string
 527      */
 528     function setBrowserAlert($message) {
 529         $this->browser_alert = $message;
 530     }
 531
 532     /**
 533      * set <noscript> message when javascript is disabled
 534      *
 535      * @params $message string
 536      */
 537     function setJSAlert($message) {
 538         $this->js_alert = $message;
 539     }
 540
 541     /**
 542      * enable map marker info windows
 543      */
 544     function enableInfoWindow() {
 545         $this->info_window = true;
 546     }
 547
 548     /**
 549      * disable map marker info windows
 550      */
 551     function disableInfoWindow() {
 552         $this->info_window = false;
 553     }
 554
 555     /**
 556      * set the info window trigger action
 557      *
 558      * @params $message string click/mouseover
 559      */
 560     function setInfoWindowTrigger($type) {
 561         switch($type) {
 562             case 'mouseover':
 563                 $this->window_trigger = 'mouseover';
 564                 break;
 565             default:
 566                 $this->window_trigger = 'click';
 567                 break;
 568             }
 569     }
 570
 571     /**
 572      * enable zoom to encompass makers
 573      */
 574     function enableZoomEncompass() {
 575         $this->zoom_encompass = true;
 576     }
 577
 578     /**
 579      * disable zoom to encompass makers
 580      */
 581     function disableZoomEncompass() {
 582         $this->zoom_encompass = false;
 583     }
 584
 585     /**
 586      * set the boundary fudge factor
 587      */
 588     function setBoundsFudge($val) {
 589         $this->bounds_fudge = $val;
 590     }
 591
 592     /**
 593      * enables the scale map control
 594      *
 595      */
 596     function enableScaleControl() {
 597         $this->scale_control = true;
 598     }
 599
 600     /**
 601      * disables the scale map control
 602      *
 603      */
 604     function disableScaleControl() {
 605         $this->scale_control = false;
 606     }
 607
 608     /**
 609      * enables the overview map control
 610      *
 611      */
 612     function enableOverviewControl() {
 613         $this->overview_control = true;
 614     }
 615
 616     /**
 617      * disables the overview map control
 618      *
 619      */
 620     function disableOverviewControl() {
 621         $this->overview_control = false;
 622      }
 623
 624
 625     /**
 626      * set the lookup service to use for geocode lookups
 627      * default is YAHOO, you can also use GOOGLE.
 628      * NOTE: GOOGLE can to intl lookups, but is not an
 629      * official API, so use at your own risk.
 630      *
 631      */
 632     function setLookupService($service) {
 633         switch($service) {
 634             case 'GOOGLE':
 635                 $this->lookup_service = 'GOOGLE';
 636                 break;
 637             case 'YAHOO':
 638             default:
 639                 $this->lookup_service = 'YAHOO';
 640                 break;
 641         }
 642     }
 643
 644
 645     /**
 646      * adds a map marker by address
 647      *
 648      * @param string $address the map address to mark (street/city/state/zip)
 649      * @param string $title the title display in the sidebar
 650      * @param string $html the HTML block to display in the info bubble (if empty, title is used)
 651      */
 652     function addMarkerByAddress($address,$title = '',$html = '',$tooltip = '',$id = '') {
 653         if(($_geocode = $this->getGeocode($address)) === false)
 654             return false;
 655         return $this->addMarkerByCoords($_geocode['lon'],$_geocode['lat'],$title,$html,$tooltip);
 656     }
 657
 658     /**
 659      * adds a map marker by geocode
 660      *
 661      * @param string $lon the map longitude (horizontal)
 662      * @param string $lat the map latitude (vertical)
 663      * @param string $title the title display in the sidebar
 664      * @param string $html|array $html
 665      *     string: the HTML block to display in the info bubble (if empty, title is used)
 666      *     array: The title => content pairs for a tabbed info bubble
 667      */
 668     // TODO make it so you can specify which tab you want the directions to appear in (add another arg)
 669     function addMarkerByCoords($lon,$lat,$title = '',$html = '',$tooltip = '',$id = '') {
 670         $_marker['lon'] = $lon;
 671         $_marker['lat'] = $lat;
 672         $_marker['html'] = (is_array($html) || strlen($html) > 0) ? $html : $title;
 673         $_marker['title'] = $title;
 674         $_marker['tooltip'] = $tooltip;
 675         $_marker['id'] = $id;
 676         $this->_markers[] = $_marker;
 677         $this->adjustCenterCoords($_marker['lon'],$_marker['lat']);
 678         // return index of marker
 679         // HACK
 680         return count($this->_markers) - 1;
 681         // HACK
 682     }
 683
 684     // HACK
 685     function deleteMarkers() {
 686         unset ($this->_markers);
 687         return;
 688     }
 689     /**
 690      * adds a map polyline by address
 691      * if color, weight and opacity are not defined, use the google maps defaults
 692      *
 693      * @param string $address1 the map address to draw from
 694      * @param string $address2 the map address to draw to
 695      * @param string $color the color of the line (format: #000000)
 696      * @param string $weight the weight of the line in pixels
 697      * @param string $opacity the line opacity (percentage)
 698      */
 699     function addPolyLineByAddress($address1,$address2,$color='',$weight=0,$opacity=0) {
 700         if(($_geocode1 = $this->getGeocode($address1)) === false)
 701             return false;
 702         if(($_geocode2 = $this->getGeocode($address2)) === false)
 703             return false;
 704         return $this->addPolyLineByCoords($_geocode1['lon'],$_geocode1['lat'],$_geocode2['lon'],$_geocode2['lat'],$color,$weight,$opacity);
 705     }
 706
 707     /**
 708      * adds a map polyline by map coordinates
 709      * if color, weight and opacity are not defined, use the google maps defaults
 710      *
 711      * @param string $lon1 the map longitude to draw from
 712      * @param string $lat1 the map latitude to draw from
 713      * @param string $lon2 the map longitude to draw to
 714      * @param string $lat2 the map latitude to draw to
 715      * @param string $color the color of the line (format: #000000)
 716      * @param string $weight the weight of the line in pixels
 717      * @param string $opacity the line opacity (percentage)
 718      */
 719     function addPolyLineByCoords($lon1,$lat1,$lon2,$lat2,$color='',$weight=0,$opacity=0) {
 720         $_polyline['lon1'] = $lon1;
 721         $_polyline['lat1'] = $lat1;
 722         $_polyline['lon2'] = $lon2;
 723         $_polyline['lat2'] = $lat2;
 724         $_polyline['color'] = $color;
 725         $_polyline['weight'] = $weight;
 726         $_polyline['opacity'] = $opacity;
 727         $this->_polylines[] = $_polyline;
 728         $this->adjustCenterCoords($_polyline['lon1'],$_polyline['lat1']);
 729         $this->adjustCenterCoords($_polyline['lon2'],$_polyline['lat2']);
 730         // return index of polyline
 731         return count($this->_polylines) - 1;
 732     }
 733
 734     /**
 735      * adjust map center coordinates by the given lat/lon point
 736      *
 737      * @param string $lon the map latitude (horizontal)
 738      * @param string $lat the map latitude (vertical)
 739      */
 740     function adjustCenterCoords($lon,$lat) {
 741         if(strlen((string)$lon) == 0 || strlen((string)$lat) == 0)
 742             return false;
 743         $this->_max_lon = (float) max($lon, $this->_max_lon);
 744         $this->_min_lon = (float) min($lon, $this->_min_lon);
 745         $this->_max_lat = (float) max($lat, $this->_max_lat);
 746         $this->_min_lat = (float) min($lat, $this->_min_lat);
 747
 748         $this->center_lon = (float) ($this->_min_lon + $this->_max_lon) / 2;
 749         $this->center_lat = (float) ($this->_min_lat + $this->_max_lat) / 2;
 750         return true;
 751     }
 752
 753     /**
 754      * set map center coordinates to lat/lon point
 755      *
 756      * @param string $lon the map latitude (horizontal)
 757      * @param string $lat the map latitude (vertical)
 758      */
 759     function setCenterCoords($lon,$lat) {
 760         $this->center_lat = (float) $lat;
 761         $this->center_lon = (float) $lon;
 762     }
 763
 764     /**
 765      * generate an array of params for a new marker icon image
 766      * iconShadowImage is optional
 767      * If anchor coords are not supplied, we use the center point of the image by default.
 768      * Can be called statically. For private use by addMarkerIcon() and setMarkerIcon()
 769      *
 770      * @param string $iconImage URL to icon image
 771      * @param string $iconShadowImage URL to shadow image
 772      * @param string $iconAnchorX X coordinate for icon anchor point
 773      * @param string $iconAnchorY Y coordinate for icon anchor point
 774      * @param string $infoWindowAnchorX X coordinate for info window anchor point
 775      * @param string $infoWindowAnchorY Y coordinate for info window anchor point
 776      */
 777     function createMarkerIcon($iconImage,$iconShadowImage = '',$iconAnchorX = 'x',$iconAnchorY = 'x',$infoWindowAnchorX = 'x',$infoWindowAnchorY = 'x') {
 778         $_icon_image_path = $iconImage;
 779
 780         if(!($_image_info = @getimagesize($_icon_image_path))) {
 781             die('GoogleMapAPI:createMarkerIcon: Error reading image [1]: ' . $iconImage);
 782         }
 783
 784         if($iconShadowImage) {
 785             $_shadow_image_path = $iconShadowImage;
 786             if(!($_shadow_info = @getimagesize($_shadow_image_path))) {
 787                 die('GoogleMapAPI:createMarkerIcon: Error reading image [2]: ' . $iconShadowImage);
 788             }
 789         }
 790
 791
 792         if($iconAnchorX === 'x') {
 793             $iconAnchorX = (int) ($_image_info[0] / 2);
 794         }
 795         if($iconAnchorY === 'x') {
 796             $iconAnchorY = (int) ($_image_info[1] / 2);
 797         }
 798         if($infoWindowAnchorX === 'x') {
 799             $infoWindowAnchorX = (int) ($_image_info[0] / 2);
 800         }
 801         if($infoWindowAnchorY === 'x') {
 802             $infoWindowAnchorY = (int) ($_image_info[1] / 2);
 803         }
 804
 805
 806         $icon_info = array(
 807                 'image' => $iconImage,
 808                 'iconWidth' => $_image_info[0],
 809                 'iconHeight' =>  $_image_info[1],
 810                 'iconAnchorX' => $iconAnchorX,
 811                 'iconAnchorY' => $iconAnchorY,
 812                 'infoWindowAnchorX' => $infoWindowAnchorX,
 813                 'infoWindowAnchorY' => $infoWindowAnchorY
 814                 );
 815
 816 /*
 817         if($iconShadowImage) {
 818             $icon_info = array_merge($icon_info, array('shadow' => $iconShadowImage,
 819                                                        'shadowWidth' =>  '100', $_shadow_info[0],
 820                                                        'shadowHeight' => '100', $_shadow_info[1]));
 821         }
 822 */
 823
 824         return $icon_info;
 825     }
 826
 827     /**
 828      * set the marker icon for ALL markers on the map
 829      */
 830     function setMarkerIcon($iconImage,$iconShadowImage = '',$iconAnchorX = 'x',$iconAnchorY = 'x',$infoWindowAnchorX = 'x',$infoWindowAnchorY = 'x') {
 831         $this->_icons = array($this->createMarkerIcon($iconImage,$iconShadowImage,$iconAnchorX,$iconAnchorY,$infoWindowAnchorX,$infoWindowAnchorY));
 832     }
 833
 834     /**
 835      * add an icon to go with the correspondingly added marker
 836      */
 837     function addMarkerIcon($iconImage,$iconShadowImage = '',$iconAnchorX = 'x',$iconAnchorY = 'x',$infoWindowAnchorX = 'x',$infoWindowAnchorY = 'x') {
 838         $this->_icons[] = $this->createMarkerIcon($iconImage,$iconShadowImage,$iconAnchorX,$iconAnchorY,$infoWindowAnchorX,$infoWindowAnchorY);
 839         return count($this->_icons) - 1;
 840     }
 841
 842
 843     /**
 844      * print map javascript (put just before </body>, or in <header> if using onLoad())
 845      *
 846      */
 847     function printMapJS() {
 848         echo $this->getMapJS();
 849     }
 850
 851     /**
 852      * return map javascript
 853      *
 854      */
 855     function getMapJS() {
 856         $_output = '<script type="text/javascript" charset="utf-8">' . "\n";
 857         $_output .= '//<![CDATA[' . "\n";
 858         $_output .= "/*************************************************\n";
 859         $_output .= " * Created with GoogleMapAPI " . $this->_version . "\n";
 860         $_output .= " * Author: Monte Ohrt <monte AT ohrt DOT com>\n";
 861         $_output .= " * Copyright 2005-2006 New Digital Group\n";
 862         $_output .= " * http://www.phpinsider.com/php/code/GoogleMapAPI/\n";
 863         $_output .= " *************************************************/\n";
 864
 865         $_output .= 'var points = [];' . "\n";
 866         $_output .= 'var markers = [];' . "\n";
 867         $_output .= 'var counter = 0;' . "\n";
 868         if($this->sidebar) {
 869             $_output .= 'var sidebar_html = "";' . "\n";
 870             $_output .= 'var marker_html = [];' . "\n";
 871         }
 872
 873         if($this->directions) {
 874             $_output .= 'var to_htmls = [];' . "\n";
 875             $_output .= 'var from_htmls = [];' . "\n";
 876         }
 877
 878         if(!empty($this->_icons)) {
 879             $_output .= 'var icon = [];' . "\n";
 880             for($i = 0, $j = count($this->_icons); $i<$j; $i++) {
 881                 $info = $this->_icons[$i];
 882
 883                 // hash the icon data to see if we've already got this one; if so, save some javascript
 884                 $icon_key = md5(serialize($info));
 885                 if(!isset($exist_icn[$icon_key])) {
 886
 887                     $_output .= "icon[$i] = new GIcon();\n";
 888                     $_output .= sprintf('icon[%s].image = "%s";',$i,$info['image']) . "\n";
 889                     if(isset($info['shadow'])) {
 890                         $_output .= sprintf('icon[%s].shadow = "%s";',$i,$info['shadow']) . "\n";
 891                         $_output .= sprintf('icon[%s].shadowSize = new GSize(%s,%s);',$i,$info['shadowWidth'],$info['shadowHeight']) . "\n";
 892                     }
 893                     $_output .= sprintf('icon[%s].iconSize = new GSize(%s,%s);',$i,$info['iconWidth'],$info['iconHeight']) . "\n";
 894                     $_output .= sprintf('icon[%s].iconAnchor = new GPoint(%s,%s);',$i,$info['iconAnchorX'],$info['iconAnchorY']) . "\n";
 895                     $_output .= sprintf('icon[%s].infoWindowAnchor = new GPoint(%s,%s);',$i,$info['infoWindowAnchorX'],$info['infoWindowAnchorY']) . "\n";
 896                 } else {
 897                     $_output .= "icon[$i] = icon[$exist_icn[$icon_key]];\n";
 898                 }
 899             }
 900         }
 901
 902         $_output .= 'var map = null;' . "\n";
 903
 904         if($this->onload) {
 905            $_output .= 'function onLoad() {' . "\n";
 906         }
 907
 908         if(!empty($this->browser_alert)) {
 909             $_output .= 'if (GBrowserIsCompatible()) {' . "\n";
 910         }
 911
 912         $_output .= sprintf('var mapObj = document.getElementById("%s");',$this->map_id) . "\n";
 913         $_output .= 'if (mapObj != "undefined" && mapObj != null) {' . "\n";
 914         $_output .= sprintf('map = new GMap2(document.getElementById("%s"));',$this->map_id) . "\n";
 915         if(isset($this->center_lat) && isset($this->center_lon)) {
 916                         // Special care for decimal point in lon and lat, would get lost if "wrong" locale is set; applies to (s)printf only
 917                         $_output .= sprintf('map.setCenter(new GLatLng(%s, %s), %d, %s);', number_format($this->center_lat, 6, ".", ""), number_format($this->center_lon, 6, ".", ""), $this->zoom, $this->map_type) . "\n";
 918         }
 919
 920         // zoom so that all markers are in the viewport
 921         if($this->zoom_encompass && count($this->_markers) > 1) {
 922             // increase bounds by fudge factor to keep
 923             // markers away from the edges
 924             $_len_lon = $this->_max_lon - $this->_min_lon;
 925             $_len_lat = $this->_max_lat - $this->_min_lat;
 926             $this->_min_lon -= $_len_lon * $this->bounds_fudge;
 927             $this->_max_lon += $_len_lon * $this->bounds_fudge;
 928             $this->_min_lat -= $_len_lat * $this->bounds_fudge;
 929             $this->_max_lat += $_len_lat * $this->bounds_fudge;
 930
 931             $_output .= "var bds = new GLatLngBounds(new GLatLng($this->_min_lat, $this->_min_lon), new GLatLng($this->_max_lat, $this->_max_lon));\n";
 932             $_output .= 'map.setZoom(map.getBoundsZoomLevel(bds));' . "\n";
 933         }
 934
 935         if($this->map_controls) {
 936           if($this->control_size == 'large')
 937               $_output .= 'map.addControl(new GLargeMapControl());' . "\n";
 938           else
 939               $_output .= 'map.addControl(new GSmallMapControl());' . "\n";
 940         }
 941         if($this->type_controls) {
 942             $_output .= 'map.addControl(new GMapTypeControl());' . "\n";
 943         }
 944
 945         if($this->scale_control) {
 946             $_output .= 'map.addControl(new GScaleControl());' . "\n";
 947         }
 948
 949         if($this->overview_control) {
 950             $_output .= 'map.addControl(new GOverviewMapControl());' . "\n";
 951         }
 952
 953                 // HACK -> DRAG
 954                 if($this->disable_drag) {
 955                         $_output .= 'map.disableDragging();'."\n";
 956                 }
 957
 958         $_output .= $this->getAddMarkersJS();
 959
 960         $_output .= $this->getPolylineJS();
 961
 962         if($this->sidebar) {
 963                 // HACK HACK
 964             //$_output .= sprintf('document.getElementById("%s").innerHTML = "<ul class=\"gmapSidebar\">"+ sidebar_html +"<\/ul>";', $this->sidebar_id) . "\n";
 965             $_output .= sprintf('document.getElementById("%s").innerHTML = "<b>Ver Eco Mupis:</b><br /><select id=\"combobox_mupis\" class=\"gmapSidebar\">"+ sidebar_html +"</select>";', 'lista_mupis') . "\n";
 966                         $_output .= 'click_sidebar($("#combobox_mupis").val())'."\n";
 967                         $_output .= '$("#combobox_mupis").change(function (){click_sidebar($("#combobox_mupis").val());})'."\n";
 968         }
 969
 970         $_output .= '}' . "\n";
 971
 972         if(!empty($this->browser_alert)) {
 973             $_output .= '} else {' . "\n";
 974                         $_output .= 'alert("' . str_replace('"','\"',$this->browser_alert) . '");' . "\n";
 975             $_output .= '}' . "\n";
 976         }
 977
 978         if($this->onload) {
 979            $_output .= '}' . "\n";
 980         }
 981
 982         $_output .= $this->getCreateMarkerJS();
 983
 984         // Utility functions used to distinguish between tabbed and non-tabbed info windows
 985         $_output .= 'function isArray(a) {return isObject(a) && a.constructor == Array;}' . "\n";
 986         $_output .= 'function isObject(a) {return (a && typeof a == \'object\') || isFunction(a);}' . "\n";
 987         $_output .= 'function isFunction(a) {return typeof a == \'function\';}' . "\n";
 988
 989         if($this->sidebar) {
 990             $_output .= 'function click_sidebar(idx) {' . "\n";
 991             //$_output .= '  alert(idx);' . "\n";
 992             $_output .= '  if(isArray(marker_html[idx])) { markers[idx].openInfoWindowTabsHtml(marker_html[idx]); }' . "\n";
 993             $_output .= '  else { markers[idx].openInfoWindowHtml(marker_html[idx]); }' . "\n";
 994                         //$_output .= '  map.updateInfoWindow();' . "\n";
 995                         $_output .= '  GEvent.trigger(markers[idx],"'.$this->window_trigger.'");' . "\n";
 996                         //$_output .= '  map.updateInfoWindow();' . "\n";
 997             $_output .= '}' . "\n";
 998         }
 999 /*
1000         $_output .= 'function showInfoWindow(idx,html) {' . "\n";
1001         $_output .= 'map.centerAtLatLng(points[idx]);' . "\n";
1002         $_output .= 'markers[idx].openInfoWindowHtml(html);' . "\n";
1003         $_output .= '}' . "\n";
1004 */
1005 /*
1006         if($this->directions) {
1007             $_output .= 'function tohere(idx) {' . "\n";
1008             $_output .= 'markers[idx].openInfoWindowHtml(to_htmls[idx]);' . "\n";
1009             $_output .= '}' . "\n";
1010             $_output .= 'function fromhere(idx) {' . "\n";
1011             $_output .= 'markers[idx].openInfoWindowHtml(from_htmls[idx]);' . "\n";
1012             $_output .= '}' . "\n";
1013
1014         }
1015 */
1016         $_output .= '//]]>' . "\n";
1017         $_output .= '</script>' . "\n";
1018         return $_output;
1019     }
1020
1021     /**
1022      * overridable function for generating js to add markers
1023      */
1024     function getAddMarkersJS() {
1025         $SINGLE_TAB_WIDTH = 88;    // constant: width in pixels of each tab heading (set by google)
1026         $i = 0;
1027         $_output = '';
1028         foreach($this->_markers as $_marker) {
1029             if(is_array($_marker['html'])) {
1030                 // warning: you can't have two tabs with the same header. but why would you want to?
1031                 $ti = 0;
1032                 $num_tabs = count($_marker['html']);
1033                 $tab_obs = array();
1034                 foreach($_marker['html'] as $tab => $info) {
1035                     if($ti == 0 && $num_tabs > 2) {
1036                         $width_style = sprintf(' style=\"width: %spx\"', $num_tabs * $SINGLE_TAB_WIDTH);
1037                     } else {
1038                         $width_style = '';
1039                     }
1040                     $tab = str_replace('"','\"',$tab);
1041                     $info = str_replace('"','\"',$info);
1042                                         $info = str_replace(array("\n", "\r"), "", $info);
1043                     $tab_obs[] = sprintf('new GInfoWindowTab("%s", "%s")', $tab, '<div id=\"gmapmarker\"'.$width_style.'>' . $info . '</div>');
1044                     $ti++;
1045                 }
1046                 $iw_html = '[' . join(',',$tab_obs) . ']';
1047             } else {
1048                 $iw_html = sprintf('"%s"',str_replace('"','\"','<div id="gmapmarker">' . str_replace(array("\n", "\r"), "", $_marker['html']) . '</div>'));
1049             }
1050             // HACK ID
1051             $_output .= sprintf('var point = new GLatLng(%s,%s);',$_marker['lat'],$_marker['lon']) . "\n";
1052             $_output .= sprintf('var marker = createMarker(point,"%s",%s, %s,"%s","%s");',
1053                                 str_replace('"','\"',$_marker['title']),
1054                                 str_replace('/','\/',$iw_html),
1055                                 $i,
1056                                 str_replace('"','\"',$_marker['tooltip']),
1057                                 $_marker['id']) . "\n";
1058             //TODO: in above createMarker call, pass the index of the tab in which to put directions, if applicable
1059             $_output .= 'map.addOverlay(marker);' . "\n";
1060             $i++;
1061         }
1062         return $_output;
1063     }
1064
1065     /**
1066      * overridable function to generate polyline js
1067      */
1068     function getPolylineJS() {
1069         $_output = '';
1070         foreach($this->_polylines as $_polyline) {
1071             $_output .= sprintf('var polyline = new GPolyline([new GLatLng(%s,%s),new GLatLng(%s,%s)],"%s",%s,%s);',
1072                     $_polyline['lat1'],$_polyline['lon1'],$_polyline['lat2'],$_polyline['lon2'],$_polyline['color'],$_polyline['weight'],$_polyline['opacity'] / 100.0) . "\n";
1073             $_output .= 'map.addOverlay(polyline);' . "\n";
1074         }
1075         return $_output;
1076     }
1077
1078     /**
1079      * overridable function to generate the js for the js function for creating a marker.
1080      */
1081      // IMPORTANTE!, acá tiene que ir el hack mayor!.
1082     function getCreateMarkerJS() {
1083         $_SCRIPT_ = '$("#datos_mupis").load(\'contenido/mupis+ubicaciones+dinamico.php?accion=mupi&MUPI=\'+id);';
1084         $_output = 'function createMarker(point, title, html, n, tooltip, id) {' . "\n";
1085         $_output .= 'if(n >= '. sizeof($this->_icons) .') { n = '. (sizeof($this->_icons) - 1) ."; }\n";
1086         if(!empty($this->_icons)) {
1087             $_output .= 'var marker = new GMarker(point,{\'icon\': icon[n], \'title\': tooltip});' . "\n";
1088         } else {
1089             $_output .= 'var marker = new GMarker(point,{\'title\': tooltip});' . "\n";
1090         }
1091         if($this->directions) {
1092             $_output .= 'var tabFlag = isArray(html);' . "\n";
1093             $_output .= 'if(!tabFlag) { html = [{"contentElem": html}]; }' . "\n";
1094             $_output .= 'if(!tabFlag) { html = html[0].contentElem; }';
1095         }
1096
1097         if($this->info_window) {
1098             $_output .= sprintf('if(isArray(html)) { GEvent.addListener(marker, "%s", function() { marker.openInfoWindowTabsHtml(html); }); }',$this->window_trigger) . "\n";
1099             $_output .= sprintf('else { GEvent.addListener(marker, "%s", function() { marker.openInfoWindowHtml(html); '.$_SCRIPT_.' }); }',$this->window_trigger) . "\n";
1100                         $_output .= 'GEvent.addListener(marker, "infowindowclose", function() { $("#datos_mupis").html(""); });' . "\n";
1101         }
1102         $_output .= 'points[counter] = point;' . "\n";
1103         $_output .= 'markers[counter] = marker;' . "\n";
1104         if($this->sidebar) {
1105             $_output .= 'marker_html[counter] = html;' . "\n";
1106             // HACK HACK
1107             //$_output .= "sidebar_html += '<li class=\"gmapSidebarItem\" id=\"gmapSidebarItem_'+ counter +'\"><a href=\"javascript:click_sidebar(' + counter + ')\">' + title + '<\/a><\/li>';" . "\n";
1108             $_output .= 'sidebar_html += \'<option class="gmapSidebarItem" id="gmapSidebarItem" value="\'+counter+\'">\' + title + \'</option>\';' . "\n";
1109         }
1110         $_output .= 'counter++;' . "\n";
1111         $_output .= 'return marker;' . "\n";
1112         $_output .= '}' . "\n";
1113         return $_output;
1114     }
1115
1116     /**
1117      * print map (put at location map will appear)
1118      *
1119      */
1120     function printMap() {
1121         echo $this->getMap();
1122     }
1123
1124     /**
1125      * return map
1126      *
1127      */
1128     function getMap() {
1129         $_output = '';
1130         if(strlen($this->width) > 0 && strlen($this->height) > 0) {
1131             $_output .= sprintf('<div id="%s" style="width: %s; height: %s"></div>',$this->map_id,$this->width,$this->height) . "\n";
1132         } else {
1133             $_output .= sprintf('<div id="%s"></div>;',$this->map_id) . "\n";
1134         }
1135         return $_output;
1136     }
1137
1138
1139     /**
1140      * print sidebar (put at location sidebar will appear)
1141      *
1142      */
1143     function printSidebar() {
1144         echo $this->getSidebar();
1145     }
1146
1147     /**
1148      * return sidebar html
1149      *
1150      */
1151     function getSidebar() {
1152         return sprintf('<div id="%s"></div>',$this->sidebar_id) . "\n";
1153     }
1154
1155     /**
1156      * get the geocode lat/lon points from given address
1157      * look in cache first, otherwise get from Yahoo
1158      *
1159      * @param string $address
1160      */
1161     function getGeocode($address) {
1162         if(empty($address))
1163             return false;
1164
1165         $_geocode = false;
1166
1167         if(($_geocode = $this->getCache($address)) === false) {
1168             if(($_geocode = $this->geoGetCoords($address)) !== false) {
1169                 $this->putCache($address, $_geocode['lon'], $_geocode['lat']);
1170             }
1171         }
1172
1173         return $_geocode;
1174     }
1175
1176     /**
1177      * get the geocode lat/lon points from cache for given address
1178      *
1179      * @param string $address
1180      */
1181     function getCache($address) {
1182         if(!isset($this->dsn))
1183             return false;
1184
1185         $_ret = array();
1186
1187         // PEAR DB
1188         require_once('DB.php');
1189         $_db =& DB::connect($this->dsn);
1190         if (PEAR::isError($_db)) {
1191             die($_db->getMessage());
1192         }
1193                 $_res =& $_db->query("SELECT lon,lat FROM {$this->_db_cache_table} where address = ?", $address);
1194         if (PEAR::isError($_res)) {
1195             die($_res->getMessage());
1196         }
1197         if($_row = $_res->fetchRow()) {
1198             $_ret['lon'] = $_row[0];
1199             $_ret['lat'] = $_row[1];
1200         }
1201
1202         $_db->disconnect();
1203
1204         return !empty($_ret) ? $_ret : false;
1205     }
1206
1207     /**
1208      * put the geocode lat/lon points into cache for given address
1209      *
1210      * @param string $address
1211      * @param string $lon the map latitude (horizontal)
1212      * @param string $lat the map latitude (vertical)
1213      */
1214     function putCache($address, $lon, $lat) {
1215         if(!isset($this->dsn) || (strlen($address) == 0 || strlen($lon) == 0 || strlen($lat) == 0))
1216            return false;
1217         // PEAR DB
1218         require_once('DB.php');
1219         $_db =& DB::connect($this->dsn);
1220         if (PEAR::isError($_db)) {
1221             die($_db->getMessage());
1222         }
1223
1224         $_res =& $_db->query('insert into '.$this->_db_cache_table.' values (?, ?, ?)', array($address, $lon, $lat));
1225         if (PEAR::isError($_res)) {
1226             die($_res->getMessage());
1227         }
1228         $_db->disconnect();
1229
1230         return true;
1231
1232     }
1233
1234     /**
1235      * get geocode lat/lon points for given address from Yahoo
1236      *
1237      * @param string $address
1238      */
1239     function geoGetCoords($address,$depth=0) {
1240
1241         switch($this->lookup_service) {
1242
1243             case 'GOOGLE':
1244
1245                 $_url = sprintf('http://%s/maps/geo?&q=%s&output=csv&key=%s',$this->lookup_server['GOOGLE'],rawurlencode($address),$this->api_key);
1246
1247                 $_result = false;
1248
1249                 if($_result = $this->fetchURL($_url)) {
1250
1251                     $_result_parts = explode(',',$_result);
1252                     if($_result_parts[0] != 200)
1253                         return false;
1254                     $_coords['lat'] = $_result_parts[2];
1255                     $_coords['lon'] = $_result_parts[3];
1256                 }
1257
1258                 break;
1259
1260             case 'YAHOO':
1261             default:
1262
1263                 $_url = 'http://%s/MapsService/V1/geocode';
1264                 $_url .= sprintf('?appid=%s&location=%s',$this->lookup_server['YAHOO'],$this->app_id,rawurlencode($address));
1265
1266                 $_result = false;
1267
1268                 if($_result = $this->fetchURL($_url)) {
1269
1270                     preg_match('!<Latitude>(.*)</Latitude><Longitude>(.*)</Longitude>!U', $_result, $_match);
1271
1272                     $_coords['lon'] = $_match[2];
1273                     $_coords['lat'] = $_match[1];
1274
1275                 }
1276
1277                 break;
1278         }
1279
1280         return $_coords;
1281     }
1282
1283
1284
1285     /**
1286      * fetch a URL. Override this method to change the way URLs are fetched.
1287      *
1288      * @param string $url
1289      */
1290     function fetchURL($url) {
1291
1292         return file_get_contents($url);
1293
1294     }
1295
1296     /**
1297      * get distance between to geocoords using great circle distance formula
1298      *
1299      * @param float $lat1
1300      * @param float $lat2
1301      * @param float $lon1
1302      * @param float $lon2
1303      * @param float $unit   M=miles, K=kilometers, N=nautical miles, I=inches, F=feet
1304      */
1305     function geoGetDistance($lat1,$lon1,$lat2,$lon2,$unit='K') {
1306
1307       // calculate miles
1308       $M =  69.09 * rad2deg(acos(sin(deg2rad($lat1)) * sin(deg2rad($lat2)) +  cos(deg2rad($lat1)) * cos(deg2rad($lat2)) * cos(deg2rad($lon1 - $lon2))));
1309
1310       switch(strtoupper($unit))
1311       {
1312         case 'K':
1313           // kilometers
1314           return $M * 1.609344;
1315           break;
1316         case 'N':
1317           // nautical miles
1318           return $M * 0.868976242;
1319           break;
1320         case 'F':
1321           // feet
1322           return $M * 5280;
1323           break;
1324         case 'I':
1325           // inches
1326           return $M * 63360;
1327           break;
1328         case 'M':
1329         default:
1330           // miles
1331           return $M;
1332           break;
1333       }
1334
1335     }
1336
1337 }
1338 ?>