phpDocumentor GoogleMapAPI
[ class tree: GoogleMapAPI ] [ index: GoogleMapAPI ] [ all elements ]

Class: GoogleMapAPI

Source Location: /GoogleMap.php

Class GoogleMapAPI

Class Overview

PHP Google Maps API class

Located in /GoogleMap.php [line 58]



		
				Author(s):
		
Information Tags:
Version:  3.0beta

Properties

Methods

[ Top ]
Property Summary
string   $ads_channel   Google Adsense Channel ID
bool   $ads_manager   enables Google Adsense Adsmanager on page, not currently supported in beta
int   $ads_max   The Max number of Adsmanager ads to show on a map
string   $ads_pub_id   Google Adsense Publisher ID
string   $app_id   DEPRECATED: Google now has geocoding service.
bool   $avoid_highways   enables/disables avoid highways on directions
bool   $avoid_tollways   determines if avoid tollways is used in directions
bool   $biking_directions   enables/disables biking directions on directions
bool   $biking_overlay   determines if biking overlay is displayed on map
float   $bounds_fudge   factor by which to fudge the boundaries so that when we zoom encompass, the markers aren't too close to the edge
string   $browser_alert   message that pops up when the browser is incompatible with Google Maps.
float   $center_lat   map center latitude (horizontal) calculated automatically as markers are added to the map.
float   $center_lon   map center longitude (vertical) calculated automatically as markers are added to the map.
string   $control_size   determines the map control type small -> show move/center controls large -> show move/center/zoom controls
string   $default_icon   Default icon image location.
string   $default_icon_shadow   Default icon shadow image location.
bool   $directions   determines if to/from directions are included inside info window
string   $directions_unit_system   determines unit system to use for directions, blank = default
mixed   $display_map   determines whether or not to display the map and associated JS on the page
array   $driving_dir_text  
string   $dsn   PEAR::DB DSN for geocode caching. example: $dsn = 'mysql://user:pass@localhost/dbname';
mixed   $elevation_directions   determines whether or not to display an elevation chart for directions that are added to the map.
mixed   $elevation_markers   determines whether or not to display a marker on the "line" when
string   $height   determines the map height
bool   $info_window   determines if map markers bring up an info window
string   $js_alert   message that appears when javascript is disabled.
bool   $local_search   enables/disables local search on page
bool   $local_search_ads   enables local search ads on page NOTE: will only display ads if local_search == true, otherwise just use ad_manager and settings.
mixed   $lookup_server  
string   $lookup_service   what server geocode lookups come from
bool   $map_controls   enables map controls (zoom/move/center)
string   $map_id   current map id, set when you instantiate the GoogleMapAPI object.
string   $map_type   default map type google.maps.MapTypeId.(ROADMAP, SATELLITE, HYBRID, TERRAIN)
mixed   $marker_clusterer   determines whether or not to use the MarkerClusterer plugin
mixed   $marker_clusterer_location   set default marker clusterer *webserver* file location
mixed   $marker_clusterer_options   set default marker clusterer options
bool   $mobile   Whether to use new V3 mobile functionality
bool   $onload   use onLoad() to load the map javascript.
bool   $overview_control   enables overview map control
bool   $scale_control   enables scale map control
bool   $scrollwheel   class variable to control scrollwheel
bool   $sidebar   determines if sidebar is enabled
string   $sidebar_id   sidebar <div> used along with this map.
mixed   $street_view_controls   determines whether or not to display street view controls
mixed   $street_view_dom_id   ID of the container that will hold a street view if streetview controls = true.
bool   $traffic_overlay   determines if traffic overlay is displayed on map
bool   $type_controls   enables map type controls (map/satellite/hybrid/terrain)
string   $type_controls_style   sets default option for type controls(DEFAULT, HORIZONTAL_BAR, DROPDOWN_MENU)
float   $use_suggest   use the first suggestion by a google lookup if exact match not found
bool   $walking_directions   enables/disables walking directions option
string   $width   determines the map width
string   $window_trigger   determines if info window appears with a click or mouseover
int   $zoom   determines the default zoom level
bool   $zoom_encompass   determines if we should zoom to minimum level (above this->zoom value) that will encompass all markers
string   $_db_cache_table   database cache table name
mixed   $_directions   Class variable that will store information to render directions
string   $_directions_header   Class variable that will store generated header code for JS to display directions
mixed   $_display_js_functions   Class variable to store whether or not to display JS functions in the header
mixed   $_elevation_polylines   list of polylines that should have an elevation profile rendered.
array   $_icons   icon info array
mixed   $_kml_overlays   list of added kml overlays
array   $_markers   list of added markers
array   $_marker_icons   marker icon info array
float   $_max_lat   max latitude
float   $_max_lon   maximum longitude of all markers
bool   $_minify_js   Class variable that will store flag to minify js - this can be overwritten after object is instantiated. Include JSMin.php if you want to use JS Minification.
float   $_min_lat   min latitude
float   $_min_lon   minimum longitude of all markers
array   $_overlays   list of added overlays
array   $_polylines   list of added polylines
string   $_version   version number

[ Top ]
Method Summary
GoogleMapAPI   GoogleMapAPI()   class constructor
void   addDirections()   Add directions route to the map and adds text directions container with id=$dom_id
string   addIcon()   add an icon to "iconset"
void   addKMLOverlay()   function to add a KML overlay to the map.
int|bool   addMarkerByAddress()   adds a map marker by address - DEPRECATION WARNING: Tabs are no longer supported in V3, if this changes this can be easily updated.
int|bool   addMarkerByCoords()   adds a map marker by lat/lng coordinates - DEPRECATION WARNING: Tabs are no longer supported in V3, if this changes this can be easily updated.
bool   addMarkerOpener()   adds a DOM object ID to specified marker to open the marker's info window.
void   addOverlay()   function to add an overlay to the map.
bool|int   addPolyLineByAddress()   adds a map polyline by address if color, weight and opacity are not defined, use the google maps defaults
bool|int   addPolylineByAddressArray()   adds polyline by passed array
string   addPolyLineByCoords()   adds a map polyline by map coordinates if color, weight and opacity are not defined, use the google maps defaults
bool|int   addPolylineByCoordsArray()   adds polyline by passed array
void   addPolylineElevation()   function to add an elevation profile for a polyline to the page
void   adjustCenterCoords()   adjust map center coordinates by the given lat/lon point
void   attachStreetViewContainer()   attach a dom id object as a streetview container to the map NOTE: Only one container can be attached to a map.
array   createMarkerIcon()   generate an array of params for a new marker icon image iconShadowImage is optional If anchor coords are not supplied, we use the center point of the image by default.
void   disableAds()   disable Google Adsense admanager on Map (not supported in V3 API)
void   disableAvoidHighways()   disables avoid highways in directions
void   disableAvoidTolls()   disables avoid tolls in directions
void   disableBikingDirections()   disables biking directions
void   disableBikingOverlay()   disable biking overlay (default)
void   disableClustering()   disable map marker clustering
void   disableDirections()   disables map directions inside info window
void   disableElevationDirections()   disable elevation to be displayed for directions
void   disableElevationMarker()   disable elevation marker
void   disableInfoWindow()   disable map marker info windows
void   disableLocalSearch()   disables the type controls (map/satellite/hybrid)
void   disableLocalSearchAds()   disables the type controls (map/satellite/hybrid)
void   disableMapControls()   disables the map controls (zoom/move)
void   disableMapDisplay()   function to disable map display (used to display street view only)
void   disableOnLoad()   disables onload
void   disableOverviewControl()   disables the overview map control
void   disableScaleControl()   disables the scale map control
void   disableScrollWheel()   disable mouse scrollwheel on Map
void   disableSidebar()   disables sidebar
void   disableStreetViewControls()   disable biking overlay (default)
void   disableTrafficOverlay()   disable traffic overlay (default)
void   disableTypeControls()   disables the type controls (map/satellite/hybrid)
void   disableWalkingDirections()   disables walking directions
void   disableZoomEncompass()   disable zoom to encompass makers
void   enableAds()   enable Google Adsense admanager on Map (not supported in V3 API)
void   enableAvoidHighways()   enables avoid highways in directions
void   enableAvoidTolls()   enables avoid tolls in directions
void   enableBikingDirections()   enables biking directions
void   enableBikingOverlay()   enable biking overlay
void   enableClustering()   enable map marker clustering
void   enableDirections()   enables map directions inside info window
void   enableElevationDirections()   enable elevation to be displayed for directions
void   enableElevationMarker()   enable elevation marker to be displayed
void   enableInfoWindow()   enable map marker info windows
void   enableLocalSearch()   enables the type controls (map/satellite/hybrid)
void   enableLocalSearchAds()   enables the type controls (map/satellite/hybrid)
void   enableMapControls()   enables the map controls (zoom/move)
void   enableMapDisplay()   function to enable map display
void   enableOnLoad()   enables onload
void   enableOverviewControl()   enables the overview map control
void   enableScaleControl()   enables the scale map control
void   enableSidebar()   enables sidebar
void   enableStreetViewControls()   enable biking overlay
void   enableTrafficOverlay()   enable traffic overlay
void   enableTypeControls()   enables the type controls (map/satellite/hybrid)
void   enableWalkingDirections()   enables walking directions
void   enableZoomEncompass()   enable zoom to encompass makers
void   fetchURL()   fetch a URL. Override this method to change the way URLs are fetched.
bool|array   geoGetCoords()   get geocode lat/lon points for given address from Yahoo
bool|array   geoGetCoordsFull()   get full geocode information for given address from Google NOTE: This does not use the getCache function as there is a lot of data in a full geocode response to cache.
float   geoGetDistance()   get distance between to geocoords using great circle distance formula
void   getAddDirectionsJS()   function to render proper calls for directions - for now can only be used on a map, not a streetview
void   getAddMarkersJS()   overridable function for generating js to add markers
void   getAddOverlayJS()   function to get overlay creation JS.
bool|array   getCache()   get the geocode lat/lon points from cache for given address
void   getCreateMarkerJS()   overridable function to generate the js for the js function for creating a marker.
void   getCreateOverlayJS()   Get create overlay js
void   getElevationMarkerJS()   create JS that is inside of JS plot elevation function
array   getGeocode()   get the geocode lat/lon points from given address look in cache first, otherwise get from Yahoo
void   getHeaderJS()   return map header javascript (goes between <head></head>)
string   getIconKey()   function to get icon key
void   getMap()   return map
void   getMapFunctions()   function to render utility functions for use on the page
void   getMapJS()   return map javascript
void   getOnLoad()   return js to set onload function
void   getOnLoadFunction()   return js to set onload function
void   getPlotElevationJS()   print helper function to draw elevation results as a chart
void   getPolylineJS()   overridable function to generate polyline js - for now can only be used on a map, not a streetview
void   getSidebar()   return sidebar html
void   getUtilityFunctions()  
void   printHeaderJS()   print map header javascript (goes between <head></head>)
void   printMap()   print map (put at location map will appear)
void   printMapJS()   print map javascript (put just before </body>, or in <header> if using onLoad())
void   printOnLoad()   prints onLoad() without having to manipulate body tag.
void   printOnLoadFunction()   print onLoad function name
void   printSidebar()   print sidebar (put at location sidebar will appear)
bool   putCache()   put the geocode lat/lon points into cache for given address
void   setBoundsFudge()   set the boundary fudge factor
void   setBrowserAlert()   set browser alert message for incompatible browsers
void   setCenterCoords()   set map center coordinates to lat/lon point
void   setClusterLocation()   Set clustering library file location
void   setClusterOptions()   set clustering options
void   setControlSize()   sets the map control size (large/small)
void   setDSN()   sets the PEAR::DB dsn
string|false   setHeight()   sets the height of the map
void   setInfoWindowTrigger()   set the info window trigger action
void   setJSAlert()   set <noscript> message when javascript is disabled
void   setLookupService()   set the lookup service to use for geocode lookups default is YAHOO, you can also use GOOGLE.
void   setMapType()   set default map type (map/satellite/hybrid)
string   setMarkerIcon()   set the default marker icon for ALL markers on the map NOTE: This MUST be set prior to adding markers in order for the defaults to be set correctly.
string   setMarkerIconKey()   function to check if icon is in class "marker_iconset", if it is,
void   setTypeControlsStyle()   sets map control style
string|false   setWidth()   sets the width of the map
void   setZoomLevel()   sets the default map zoom level
void   updateMarkerIconKey()   updates a marker's icon key.

[ Top ]
Properties
string   $ads_channel = "" [line 218]

Google Adsense Channel ID


[ Top ]
bool   $ads_manager = false [line 204]

enables Google Adsense Adsmanager on page, not currently supported in beta


[ Top ]
int   $ads_max = 10 [line 225]

The Max number of Adsmanager ads to show on a map


[ Top ]
string   $ads_pub_id = "" [line 211]

Google Adsense Publisher ID


[ Top ]
string   $app_id = null [line 106]

DEPRECATED: Google now has geocoding service.

NOTE: Note even sure if this still works GoogleMapAPI used to use the Yahoo geocode lookup API. This is the application ID for YOUR application. This is set upon instantiating the GoogleMapAPI object. (http://developer.yahoo.net/faq/index.html#appid)


[ Top ]
bool   $avoid_highways = false [line 260]

enables/disables avoid highways on directions


[ Top ]
bool   $avoid_tollways = false [line 267]

determines if avoid tollways is used in directions


[ Top ]
bool   $biking_directions = false [line 253]

enables/disables biking directions on directions


[ Top ]
bool   $biking_overlay = false [line 366]

determines if biking overlay is displayed on map


[ Top ]
float   $bounds_fudge = 0.01 [line 464]

factor by which to fudge the boundaries so that when we zoom encompass, the markers aren't too close to the edge


[ Top ]
string   $browser_alert = 'Sorry, the Google Maps API is not compatible with this browser.' [line 296]

message that pops up when the browser is incompatible with Google Maps.

set to empty string to disable.


[ Top ]
float   $center_lat = null [line 126]

map center latitude (horizontal) calculated automatically as markers are added to the map.


[ Top ]
float   $center_lon = null [line 135]

map center longitude (vertical) calculated automatically as markers are added to the map.


[ Top ]
string   $control_size = 'large' [line 151]

determines the map control type small -> show move/center controls large -> show move/center/zoom controls


[ Top ]
string   $default_icon = "" [line 520]

Default icon image location.


[ Top ]
string   $default_icon_shadow = "" [line 527]

Default icon shadow image location.


[ Top ]
bool   $directions = true [line 319]

determines if to/from directions are included inside info window

API Tags:
Deprecated:  


[ Top ]
string   $directions_unit_system = '' [line 164]

determines unit system to use for directions, blank = default


[ Top ]
mixed   $display_map = true [line 80]

determines whether or not to display the map and associated JS on the page

this is used if you just want to display a streetview with no map


[ Top ]
array   $driving_dir_text = array(
'dir_to' => 'Start address: (include addr, city st/region)',
'to_button_value' => 'Get Directions',
'to_button_type' => 'submit',
'dir_from' => 'End address: (include addr, city st/region)',
'from_button_value' => 'Get Directions',
'from_button_type' => 'submit',
'dir_text' => 'Directions: ',
'dir_tohere' => 'To here',
'dir_fromhere' => 'From here'
)
[line 397]
API Tags:
Deprecated:  


[ Top ]
string   $dsn = null [line 66]

PEAR::DB DSN for geocode caching. example: $dsn = 'mysql://user:pass@localhost/dbname';


[ Top ]
mixed   $elevation_directions = false [line 496]

determines whether or not to display an elevation chart for directions that are added to the map.


[ Top ]
mixed   $elevation_markers = true [line 490]

determines whether or not to display a marker on the "line" when

mousing over the elevation chart


[ Top ]
string   $height = '500px' [line 288]

determines the map height


[ Top ]
bool   $info_window = true [line 326]

determines if map markers bring up an info window


[ Top ]
string   $js_alert = '<b>Javascript must be enabled in order to use Google Maps.</b>' [line 304]

message that appears when javascript is disabled.

set to empty string to disable.


[ Top ]
bool   $local_search = false [line 232]

enables/disables local search on page


[ Top ]
bool   $local_search_ads = false [line 239]

enables local search ads on page NOTE: will only display ads if local_search == true, otherwise just use ad_manager and settings.


[ Top ]
mixed   $lookup_server = array('GOOGLE' => 'maps.google.com', 'YAHOO' => 'api.local.yahoo.com') [line 390]

[ Top ]
string   $lookup_service = 'GOOGLE' [line 389]

what server geocode lookups come from

available: YAHOO Yahoo! API. US geocode lookups only. GOOGLE Google Maps. This can do international lookups, but not an official API service so no guarantees. Note: GOOGLE is the default lookup service, please read the Yahoo! terms of service before using their API.


[ Top ]
bool   $map_controls = true [line 142]

enables map controls (zoom/move/center)


[ Top ]
string   $map_id = null [line 74]

current map id, set when you instantiate the GoogleMapAPI object.


[ Top ]
string   $map_type = 'HYBRID' [line 178]

default map type google.maps.MapTypeId.(ROADMAP, SATELLITE, HYBRID, TERRAIN)


[ Top ]
mixed   $marker_clusterer = false [line 338]

determines whether or not to use the MarkerClusterer plugin


[ Top ]
mixed   $marker_clusterer_location = "/MarkerClusterer-1.0/markerclusterer_compiled.js" [line 343]

set default marker clusterer *webserver* file location


[ Top ]
mixed   $marker_clusterer_options = array(
"maxZoom"=>"null",
"gridSize"=>"null",
"styles"=>"null"
)
[line 348]

set default marker clusterer options


[ Top ]
bool   $mobile = false [line 94]

Whether to use new V3 mobile functionality


[ Top ]
bool   $onload = true [line 117]

use onLoad() to load the map javascript.

if enabled, be sure to include on your webpage: <?=$mapobj->printOnLoad?> or manually create an onload function that calls the map's onload function using $this->printOnLoadFunction


[ Top ]
bool   $overview_control = false [line 197]

enables overview map control


[ Top ]
bool   $scale_control = true [line 185]

enables scale map control


[ Top ]
bool   $scrollwheel = true [line 190]

class variable to control scrollwheel


[ Top ]
bool   $sidebar = true [line 311]

determines if sidebar is enabled


[ Top ]
string   $sidebar_id = null [line 87]

sidebar <div> used along with this map.


[ Top ]
mixed   $street_view_controls = false [line 371]

determines whether or not to display street view controls


[ Top ]
mixed   $street_view_dom_id = "" [line 376]

ID of the container that will hold a street view if streetview controls = true.


[ Top ]
bool   $traffic_overlay = false [line 359]

determines if traffic overlay is displayed on map


[ Top ]
bool   $type_controls = true [line 158]

enables map type controls (map/satellite/hybrid/terrain)


[ Top ]
string   $type_controls_style = "DEFAULT" [line 171]

sets default option for type controls(DEFAULT, HORIZONTAL_BAR, DROPDOWN_MENU)


[ Top ]
float   $use_suggest = false [line 471]

use the first suggestion by a google lookup if exact match not found


[ Top ]
bool   $walking_directions = false [line 246]

enables/disables walking directions option


[ Top ]
string   $width = '500px' [line 281]

determines the map width


[ Top ]
string   $window_trigger = 'click' [line 333]

determines if info window appears with a click or mouseover


[ Top ]
int   $zoom = 16 [line 274]

determines the default zoom level


[ Top ]
bool   $zoom_encompass = true [line 457]

determines if we should zoom to minimum level (above this->zoom value) that will encompass all markers


[ Top ]
string   $_db_cache_table = 'GEOCODES' [line 547]

database cache table name


[ Top ]
mixed   $_directions = array() [line 559]

Class variable that will store information to render directions


[ Top ]
string   $_directions_header = '' [line 554]

Class variable that will store generated header code for JS to display directions


[ Top ]
mixed   $_display_js_functions = true [line 564]

Class variable to store whether or not to display JS functions in the header


[ Top ]
mixed   $_elevation_polylines = array() [line 484]

list of polylines that should have an elevation profile rendered.


[ Top ]
array   $_icons = array() [line 505]

icon info array

API Tags:
Deprecated:  

Information Tags:
Version:  2.5

[ Top ]
mixed   $_kml_overlays = array() [line 539]

list of added kml overlays


[ Top ]
array   $_markers = array() [line 422]

list of added markers


[ Top ]
array   $_marker_icons = array() [line 513]

marker icon info array

Information Tags:
Version:  3.0

[ Top ]
float   $_max_lat = -1000000 [line 443]

max latitude


[ Top ]
float   $_max_lon = -1000000 [line 429]

maximum longitude of all markers


[ Top ]
bool   $_minify_js = true [line 572]

Class variable that will store flag to minify js - this can be overwritten after object is instantiated. Include JSMin.php if you want to use JS Minification.


[ Top ]
float   $_min_lat = 1000000 [line 450]

min latitude


[ Top ]
float   $_min_lon = 1000000 [line 436]

minimum longitude of all markers


[ Top ]
array   $_overlays = array() [line 534]

list of added overlays


[ Top ]
array   $_polylines = array() [line 479]

list of added polylines


[ Top ]
string   $_version = '3.0beta' [line 415]

version number


[ Top ]
Methods
Constructor GoogleMapAPI  [line 580]

  GoogleMapAPI GoogleMapAPI( [string $map_id = 'map'], [string $app_id = 'MyMapApp']  )

class constructor

Parameters:
string   $map_id:  the DOM element ID for the map
string   $app_id:  YOUR Yahoo App ID


[ Top ]
addDirections  [line 796]

  void addDirections( [string $start_address = ''], [string $dest_address = ''], [string $dom_id = ''], [bool $add_markers = true], [ $elevation_samples = 256], [ $elevation_width = ""], [ $elevation_height = ""], [ $elevation_dom_id = '']  )

Add directions route to the map and adds text directions container with id=$dom_id

Parameters:
string   $start_address: 
string   $dest_address: 
string   $dom_id:  DOM Element ID for directions container.
bool   $add_markers:  Add a marker at start and dest locations.
   $elevation_samples: 
   $elevation_width: 
   $elevation_height: 
   $elevation_dom_id: 


[ Top ]
addIcon  [line 1558]

  string addIcon( string $iconImage, [ $iconShadowImage = ''], [string $iconAnchorX = 'x'], [string $iconAnchorY = 'x'], [string $infoWindowAnchorX = 'x'], [string $infoWindowAnchorY = 'x'], string $iconShadow  )

add an icon to "iconset"

Parameters:
string   $iconImage:  URL to marker icon image
string   $iconShadow:  URL to marker icon shadow image
string   $iconAnchorX:  X coordinate for icon anchor point
string   $iconAnchorY:  Y coordinate for icon anchor point
string   $infoWindowAnchorX:  X coordinate for info window anchor point
string   $infoWindowAnchorY:  Y coordinate for info window anchor point
   $iconShadowImage: 

API Tags:
Return:  Returns the icon's key.


[ Top ]
addKMLOverlay  [line 1410]

  void addKMLOverlay( $file  )

function to add a KML overlay to the map.

*Note that this expects a filename and file parsing/processing is done on the client side

Parameters:
   $file: 


[ Top ]
addMarkerByAddress  [line 1181]

  int|bool addMarkerByAddress( string $address, [string $title = ''], [string $html = ''], [string $tooltip = ''], [string $icon_filename = ''], [string $icon_shadow_filename = '']  )

adds a map marker by address - DEPRECATION WARNING: Tabs are no longer supported in V3, if this changes this can be easily updated.

Parameters:
string   $address:  the map address to mark (street/city/state/zip)
string   $title:  the title display in the sidebar
string   $html:  the HTML block to display in the info bubble (if empty, title is used)
string   $tooltip:  Tooltip to display (deprecated?)
string   $icon_filename:  Web file location (eg http://somesite/someicon.gif) to use for icon
string   $icon_shadow_filename:  Web file location (eg http://somesite/someicon.gif) to use for icon shadow


[ Top ]
addMarkerByCoords  [line 1199]

  int|bool addMarkerByCoords( string $lon, string $lat, [string $title = ''], [string $html = ''], [string $tooltip = ''], [string $icon_filename = ''], [string $icon_shadow_filename = '']  )

adds a map marker by lat/lng coordinates - DEPRECATION WARNING: Tabs are no longer supported in V3, if this changes this can be easily updated.

Parameters:
string   $lon:  the map longitude (horizontal)
string   $lat:  the map latitude (vertical)
string   $title:  the title display in the sidebar
string   $html:  the HTML block to display in the info bubble (if empty, title is used)
string   $tooltip:  Tooltip to display (deprecated?)
string   $icon_filename:  Web file location (eg http://somesite/someicon.gif) to use for icon
string   $icon_shadow_filename:  Web file location (eg http://somesite/someicon.gif) to use for icon shadow


[ Top ]
addMarkerOpener  [line 1230]

  bool addMarkerOpener( string $marker_id, string $dom_id  )

adds a DOM object ID to specified marker to open the marker's info window.

Does nothing if the info windows is disabled.

Parameters:
string   $marker_id:  ID of the marker to associate to
string   $dom_id:  ID of the DOM object to use to open marker info window

API Tags:
Return:  true/false status


[ Top ]
addOverlay  [line 1384]

  void addOverlay( $bds_lat1, $bds_lon1, $bds_lat2, $bds_lon2, $img_src, [ $opacity = 100]  )

function to add an overlay to the map.

Parameters:
   $bds_lat1: 
   $bds_lon1: 
   $bds_lat2: 
   $bds_lon2: 
   $img_src: 
   $opacity: 


[ Top ]
addPolyLineByAddress  [line 1308]

  bool|int addPolyLineByAddress( string $address1, string $address2, [string $id = false], [string $color = ''], [string $weight = 0], [string $opacity = 0]  )

adds a map polyline by address if color, weight and opacity are not defined, use the google maps defaults

Parameters:
string   $address1:  the map address to draw from
string   $address2:  the map address to draw to
string   $id:  An array id to use to append coordinates to a line
string   $color:  the color of the line (format: #000000)
string   $weight:  the weight of the line in pixels
string   $opacity:  the line opacity (percentage)

API Tags:
Return:  Array id of newly added point or false


[ Top ]
addPolylineByAddressArray  [line 1279]

  bool|int addPolylineByAddressArray( array $polyline_array, [string $id = false], [string $color = ''], [string $weight = 0], [string $opacity = 0]  )

adds polyline by passed array

if color, weight and opacity are not defined, use the google maps defaults

Parameters:
array   $polyline_array:  array of addresses
string   $id:  An array id to use to append coordinates to a line
string   $color:  the color of the line (format: #000000)
string   $weight:  the weight of the line in pixels
string   $opacity:  the line opacity (percentage)

API Tags:
Return:  Array id of newly added point or false


[ Top ]
addPolyLineByCoords  [line 1330]

  string addPolyLineByCoords( string $lon1, string $lat1, string $lon2, string $lat2, [string $id = false], [string $color = ''], [string $weight = 0], [string $opacity = 0]  )

adds a map polyline by map coordinates if color, weight and opacity are not defined, use the google maps defaults

Parameters:
string   $lon1:  the map longitude to draw from
string   $lat1:  the map latitude to draw from
string   $lon2:  the map longitude to draw to
string   $lat2:  the map latitude to draw to
string   $id:  An array id to use to append coordinates to a line
string   $color:  the color of the line (format: #000000)
string   $weight:  the weight of the line in pixels
string   $opacity:  the line opacity (percentage)

API Tags:
Return:  id of the created/updated polyline array


[ Top ]
addPolylineByCoordsArray  [line 1248]

  bool|int addPolylineByCoordsArray( array $polyline_array, [string $id = false], [string $color = ''], [string $weight = 0], [string $opacity = 0]  )

adds polyline by passed array

if color, weight and opacity are not defined, use the google maps defaults

Parameters:
array   $polyline_array:  array of lat/long coords
string   $id:  An array id to use to append coordinates to a line
string   $color:  the color of the line (format: #000000)
string   $weight:  the weight of the line in pixels
string   $opacity:  the line opacity (percentage)

API Tags:
Return:  Array id of newly added point or false


[ Top ]
addPolylineElevation  [line 1369]

  void addPolylineElevation( $polyline_id, $elevation_dom_id, [ $samples = 256], [ $width = ""], [ $height = ""], [ $focus_color = "#00ff00"]  )

function to add an elevation profile for a polyline to the page

Parameters:
   $polyline_id: 
   $elevation_dom_id: 
   $samples: 
   $width: 
   $height: 
   $focus_color: 


[ Top ]
adjustCenterCoords  [line 1421]

  void adjustCenterCoords( string $lon, string $lat  )

adjust map center coordinates by the given lat/lon point

Parameters:
string   $lon:  the map latitude (horizontal)
string   $lat:  the map latitude (vertical)


[ Top ]
attachStreetViewContainer  [line 986]

  void attachStreetViewContainer( $dom_id  )

attach a dom id object as a streetview container to the map NOTE: Only one container can be attached to a map.

Parameters:
   $dom_id: 


[ Top ]
createMarkerIcon  [line 1458]

  array createMarkerIcon( string $iconImage, [string $iconShadowImage = ''], [string $iconAnchorX = 'x'], [string $iconAnchorY = 'x'], [string $infoWindowAnchorX = 'x'], [string $infoWindowAnchorY = 'x']  )

generate an array of params for a new marker icon image iconShadowImage is optional If anchor coords are not supplied, we use the center point of the image by default.

Can be called statically. For private use by addMarkerIcon() and setMarkerIcon() and addIcon()

Parameters:
string   $iconImage:  URL to icon image
string   $iconShadowImage:  URL to shadow image
string   $iconAnchorX:  X coordinate for icon anchor point
string   $iconAnchorY:  Y coordinate for icon anchor point
string   $infoWindowAnchorX:  X coordinate for info window anchor point
string   $infoWindowAnchorY:  Y coordinate for info window anchor point

API Tags:
Return:  Array with information about newly /previously created icon.


[ Top ]
disableAds  [line 1000]

  void disableAds( )

disable Google Adsense admanager on Map (not supported in V3 API)



[ Top ]
disableAvoidHighways  [line 768]

  void disableAvoidHighways( )

disables avoid highways in directions



[ Top ]
disableAvoidTolls  [line 784]

  void disableAvoidTolls( )

disables avoid tolls in directions



[ Top ]
disableBikingDirections  [line 752]

  void disableBikingDirections( )

disables biking directions



[ Top ]
disableBikingOverlay  [line 964]

  void disableBikingOverlay( )

disable biking overlay (default)



[ Top ]
disableClustering  [line 1057]

  void disableClustering( )

disable map marker clustering



[ Top ]
disableDirections  [line 918]

  void disableDirections( )

disables map directions inside info window



[ Top ]
disableElevationDirections  [line 1043]

  void disableElevationDirections( )

disable elevation to be displayed for directions



[ Top ]
disableElevationMarker  [line 1029]

  void disableElevationMarker( )

disable elevation marker



[ Top ]
disableInfoWindow  [line 1015]

  void disableInfoWindow( )

disable map marker info windows



[ Top ]
disableLocalSearch  [line 704]

  void disableLocalSearch( )

disables the type controls (map/satellite/hybrid)



[ Top ]
disableLocalSearchAds  [line 720]

  void disableLocalSearchAds( )

disables the type controls (map/satellite/hybrid)



[ Top ]
disableMapControls  [line 671]

  void disableMapControls( )

disables the map controls (zoom/move)



[ Top ]
disableMapDisplay  [line 596]

  void disableMapDisplay( )

function to disable map display (used to display street view only)



[ Top ]
disableOnLoad  [line 886]

  void disableOnLoad( )

disables onload



[ Top ]
disableOverviewControl  [line 1143]

  void disableOverviewControl( )

disables the overview map control



[ Top ]
disableScaleControl  [line 1127]

  void disableScaleControl( )

disables the scale map control



[ Top ]
disableScrollWheel  [line 688]

  void disableScrollWheel( )

disable mouse scrollwheel on Map



[ Top ]
disableSidebar  [line 902]

  void disableSidebar( )

disables sidebar



[ Top ]
disableStreetViewControls  [line 978]

  void disableStreetViewControls( )

disable biking overlay (default)



[ Top ]
disableTrafficOverlay  [line 950]

  void disableTrafficOverlay( )

disable traffic overlay (default)



[ Top ]
disableTypeControls  [line 830]

  void disableTypeControls( )

disables the type controls (map/satellite/hybrid)



[ Top ]
disableWalkingDirections  [line 736]

  void disableWalkingDirections( )

disables walking directions



[ Top ]
disableZoomEncompass  [line 1103]

  void disableZoomEncompass( )

disable zoom to encompass makers



[ Top ]
enableAds  [line 993]

  void enableAds( )

enable Google Adsense admanager on Map (not supported in V3 API)



[ Top ]
enableAvoidHighways  [line 760]

  void enableAvoidHighways( )

enables avoid highways in directions



[ Top ]
enableAvoidTolls  [line 776]

  void enableAvoidTolls( )

enables avoid tolls in directions



[ Top ]
enableBikingDirections  [line 744]

  void enableBikingDirections( )

enables biking directions



[ Top ]
enableBikingOverlay  [line 957]

  void enableBikingOverlay( )

enable biking overlay



[ Top ]
enableClustering  [line 1050]

  void enableClustering( )

enable map marker clustering



[ Top ]
enableDirections  [line 910]

  void enableDirections( )

enables map directions inside info window



[ Top ]
enableElevationDirections  [line 1036]

  void enableElevationDirections( )

enable elevation to be displayed for directions



[ Top ]
enableElevationMarker  [line 1022]

  void enableElevationMarker( )

enable elevation marker to be displayed



[ Top ]
enableInfoWindow  [line 1008]

  void enableInfoWindow( )

enable map marker info windows



[ Top ]
enableLocalSearch  [line 696]

  void enableLocalSearch( )

enables the type controls (map/satellite/hybrid)



[ Top ]
enableLocalSearchAds  [line 712]

  void enableLocalSearchAds( )

enables the type controls (map/satellite/hybrid)



[ Top ]
enableMapControls  [line 663]

  void enableMapControls( )

enables the map controls (zoom/move)



[ Top ]
enableMapDisplay  [line 589]

  void enableMapDisplay( )

function to enable map display



[ Top ]
enableOnLoad  [line 878]

  void enableOnLoad( )

enables onload



[ Top ]
enableOverviewControl  [line 1135]

  void enableOverviewControl( )

enables the overview map control



[ Top ]
enableScaleControl  [line 1119]

  void enableScaleControl( )

enables the scale map control



[ Top ]
enableSidebar  [line 894]

  void enableSidebar( )

enables sidebar



[ Top ]
enableStreetViewControls  [line 971]

  void enableStreetViewControls( )

enable biking overlay



[ Top ]
enableTrafficOverlay  [line 943]

  void enableTrafficOverlay( )

enable traffic overlay



[ Top ]
enableTypeControls  [line 822]

  void enableTypeControls( )

enables the type controls (map/satellite/hybrid)



[ Top ]
enableWalkingDirections  [line 728]

  void enableWalkingDirections( )

enables walking directions



[ Top ]
enableZoomEncompass  [line 1096]

  void enableZoomEncompass( )

enable zoom to encompass makers



[ Top ]
fetchURL  [line 2540]

  void fetchURL( string $url  )

fetch a URL. Override this method to change the way URLs are fetched.

Parameters:
string   $url: 


[ Top ]
geoGetCoords  [line 2477]

  bool|array geoGetCoords( string $address, [ $depth = 0]  )

get geocode lat/lon points for given address from Yahoo

Parameters:
string   $address: 
   $depth: 

API Tags:
Return:  false if can't be geocoded, array or geocdoes if successful


[ Top ]
geoGetCoordsFull  [line 2514]

  bool|array geoGetCoordsFull( string $address, [ $depth = 0]  )

get full geocode information for given address from Google NOTE: This does not use the getCache function as there is a lot of data in a full geocode response to cache.

Parameters:
string   $address: 
   $depth: 

API Tags:
Return:  false if can't be geocoded, array or geocdoes if successful


[ Top ]
geoGetDistance  [line 2556]

  float geoGetDistance( float $lat1, float $lon1, float $lat2, float $lon2, [float $unit = 'M']  )

get distance between to geocoords using great circle distance formula

Parameters:
float   $lat1: 
float   $lat2: 
float   $lon1: 
float   $lon2: 
float   $unit:  M=miles, K=kilometers, N=nautical miles, I=inches, F=feet


[ Top ]
getAddDirectionsJS  [line 2104]

  void getAddDirectionsJS( )

function to render proper calls for directions - for now can only be used on a map, not a streetview



[ Top ]
getAddMarkersJS  [line 2009]

  void getAddMarkersJS( [ $map_id = ""], [ $pano = false]  )

overridable function for generating js to add markers

Parameters:
   $map_id: 
   $pano: 


[ Top ]
getAddOverlayJS  [line 2172]

  void getAddOverlayJS( )

function to get overlay creation JS.



[ Top ]
getCache  [line 2420]

  bool|array getCache( string $address  )

get the geocode lat/lon points from cache for given address

Parameters:
string   $address: 

API Tags:
Return:  False if no cache, array of data if has cache


[ Top ]
getCreateMarkerJS  [line 2187]

  void getCreateMarkerJS( )

overridable function to generate the js for the js function for creating a marker.



[ Top ]
getCreateOverlayJS  [line 2234]

  void getCreateOverlayJS( )

Get create overlay js



[ Top ]
getElevationMarkerJS  [line 2313]

  void getElevationMarkerJS( )

create JS that is inside of JS plot elevation function



[ Top ]
getGeocode  [line 2402]

  array getGeocode( string $address  )

get the geocode lat/lon points from given address look in cache first, otherwise get from Yahoo

Parameters:
string   $address: 

API Tags:
Return:  GeoCode information


[ Top ]
getHeaderJS  [line 1588]

  void getHeaderJS( )

return map header javascript (goes between <head></head>)



[ Top ]
getIconKey  [line 1544]

  string getIconKey( string $iconImage, [string $iconShadow = ""]  )

function to get icon key

Parameters:
string   $iconImage:  URL to marker icon image
string   $iconShadow:  URL to marker icon shadow image

API Tags:
Return:  Returns formatted icon key from icon or icon+shadow image name pairs


[ Top ]
getMap  [line 2353]

  void getMap( )

return map



[ Top ]
getMapFunctions  [line 1982]

  void getMapFunctions( )

function to render utility functions for use on the page



[ Top ]
getMapJS  [line 1654]

  void getMapJS( )

return map javascript



[ Top ]
getOnLoad  [line 1631]

  void getOnLoad( )

return js to set onload function



[ Top ]
getOnLoadFunction  [line 1638]

  void getOnLoadFunction( )

return js to set onload function



[ Top ]
getPlotElevationJS  [line 2282]

  void getPlotElevationJS( )

print helper function to draw elevation results as a chart



[ Top ]
getPolylineJS  [line 2053]

  void getPolylineJS( )

overridable function to generate polyline js - for now can only be used on a map, not a streetview



[ Top ]
getSidebar  [line 2391]

  void getSidebar( )

return sidebar html



[ Top ]
getUtilityFunctions  [line 1990]

  void getUtilityFunctions( )



[ Top ]
printHeaderJS  [line 1580]

  void printHeaderJS( )

print map header javascript (goes between <head></head>)



[ Top ]
printMap  [line 2345]

  void printMap( )

print map (put at location map will appear)



[ Top ]
printMapJS  [line 1646]

  void printMapJS( )

print map javascript (put just before </body>, or in <header> if using onLoad())



[ Top ]
printOnLoad  [line 1617]

  void printOnLoad( )

prints onLoad() without having to manipulate body tag.

call this after the print map like so... $map->printMap(); $map->printOnLoad();



[ Top ]
printOnLoadFunction  [line 1624]

  void printOnLoadFunction( )

print onLoad function name



[ Top ]
printSidebar  [line 2383]

  void printSidebar( )

print sidebar (put at location sidebar will appear)



[ Top ]
putCache  [line 2454]

  bool putCache( string $address, string $lon, string $lat  )

put the geocode lat/lon points into cache for given address

Parameters:
string   $address: 
string   $lon:  the map latitude (horizontal)
string   $lat:  the map latitude (vertical)

API Tags:
Return:  Status of put cache request


[ Top ]
setBoundsFudge  [line 1111]

  void setBoundsFudge( float $val  )

set the boundary fudge factor

Parameters:
float   $val: 


[ Top ]
setBrowserAlert  [line 927]

  void setBrowserAlert( string $message  )

set browser alert message for incompatible browsers

Parameters:
string   $message: 


[ Top ]
setCenterCoords  [line 1439]

  void setCenterCoords( string $lon, string $lat  )

set map center coordinates to lat/lon point

Parameters:
string   $lon:  the map latitude (horizontal)
string   $lat:  the map latitude (vertical)


[ Top ]
setClusterLocation  [line 1073]

  void setClusterLocation( $file  )

Set clustering library file location

Parameters:
   $file: 


[ Top ]
setClusterOptions  [line 1064]

  void setClusterOptions( [ $zoom = "null"], [ $gridsize = "null"], [ $styles = "null"]  )

set clustering options

Parameters:
   $zoom: 
   $gridsize: 
   $styles: 


[ Top ]
setControlSize  [line 680]

  void setControlSize( string $size  )

sets the map control size (large/small)

Parameters:
string   $size:  Large/Small


[ Top ]
setDSN  [line 605]

  void setDSN( string $dsn  )

sets the PEAR::DB dsn

Parameters:
string   $dsn:  Takes the form of "mysql://user:pass@localhost/db_name"


[ Top ]
setHeight  [line 635]

  string|false setHeight( string $height  )

sets the height of the map

Parameters:
string   $height: 

API Tags:
Return:  Height or false if not a valid value


[ Top ]
setInfoWindowTrigger  [line 1082]

  void setInfoWindowTrigger( $type, string $message  )

set the info window trigger action

Parameters:
string   $message:  click/mouseover
   $type: 


[ Top ]
setJSAlert  [line 936]

  void setJSAlert( string $message  )

set <noscript> message when javascript is disabled

Parameters:
string   $message: 


[ Top ]
setLookupService  [line 1157]

  void setLookupService( string $service  )

set the lookup service to use for geocode lookups default is YAHOO, you can also use GOOGLE.

NOTE: GOOGLE can to intl lookups, but is not an official API, so use at your own risk.

Parameters:
string   $service: 

API Tags:
Deprecated:  


[ Top ]
setMapType  [line 856]

  void setMapType( string $type  )

set default map type (map/satellite/hybrid)

Parameters:
string   $type:  New V3 Map Types, only include ending word (HYBRID,SATELLITE,TERRAIN,ROADMAP)


[ Top ]
setMarkerIcon  [line 1512]

  string setMarkerIcon( string $iconImage, [string $iconShadowImage = ''], [string $iconAnchorX = 'x'], [string $iconAnchorY = 'x'], [string $infoWindowAnchorX = 'x'], [string $infoWindowAnchorY = 'x']  )

set the default marker icon for ALL markers on the map NOTE: This MUST be set prior to adding markers in order for the defaults to be set correctly.

Parameters:
string   $iconImage:  URL to icon image
string   $iconShadowImage:  URL to shadow image
string   $iconAnchorX:  X coordinate for icon anchor point
string   $iconAnchorY:  Y coordinate for icon anchor point
string   $infoWindowAnchorX:  X coordinate for info window anchor point
string   $infoWindowAnchorY:  Y coordinate for info window anchor point

API Tags:
Return:  A marker icon key.


[ Top ]
setMarkerIconKey  [line 1529]

  string setMarkerIconKey( string $iconImage, [ $iconShadow = ''], [string $iconAnchorX = 'x'], [string $iconAnchorY = 'x'], [string $infoWindowAnchorX = 'x'], [string $infoWindowAnchorY = 'x'], string $iconShadowImage  )

function to check if icon is in class "marker_iconset", if it is,

returns the key, if not, creates a new array indice and returns the key

Parameters:
string   $iconImage:  URL to icon image
string   $iconShadowImage:  URL to shadow image
string   $iconAnchorX:  X coordinate for icon anchor point
string   $iconAnchorY:  Y coordinate for icon anchor point
string   $infoWindowAnchorX:  X coordinate for info window anchor point
string   $infoWindowAnchorY:  Y coordinate for info window anchor point
   $iconShadow: 

API Tags:
Return:  A marker icon key.


[ Top ]
setTypeControlsStyle  [line 837]

  void setTypeControlsStyle( $type  )

sets map control style

Parameters:
   $type: 


[ Top ]
setWidth  [line 615]

  string|false setWidth( string $width  )

sets the width of the map

Parameters:
string   $width: 

API Tags:
Return:  Width or false if not a valid value


[ Top ]
setZoomLevel  [line 655]

  void setZoomLevel( string $level  )

sets the default map zoom level

Parameters:
string   $level:  Initial zoom level value


[ Top ]
updateMarkerIconKey  [line 1570]

  void updateMarkerIconKey( string $markerKey, string $iconKey  )

updates a marker's icon key.

NOTE: To be used in lieu of addMarkerIcon, now use addIcon + updateMarkerIconKey for explicit icon association

Parameters:
string   $markerKey:  Marker key to define which marker's icon to update
string   $iconKey:  Icon key to define which icon to use.


[ Top ]

Documentation generated on Fri, 15 Apr 2011 20:39:48 +0000 by phpDocumentor 1.4.3