Beginning Google Maps Applications with PHP and Ajax From Novice to Professional PHẦN 10 ppt

Method Returns Description showMapBlowup Opens an info window at the given GLatLng, (latlng, [opts]) which contains a close-up view on the map centered on the given GLatLng. closeInfoWindow() Closes the current info window. getInfoWindow() GInfoWindow Returns the info window object of this map. If no info window exists, it is created but not displayed. enableInfoWindow() does not affect the result of getInfoWindow(). Coordinate Transformations Method Returns Description fromLatLngToDivPixel(latlng) GPoint Returns the GPoint pixel coordinates of the given GLatLng geographical location, relative to the DOM element that contains the draggable map. fromDivPixelToLatLng(pixel) GLatLng Returns the GLatLng geographical coordinates of the given GPoint pixel coordinates, relative to the DOM element that contains the draggable map. fromContainerPixelToLatLng(pixel) GLatLng Returns the GLatLng geographical coordi- nates of the given GPoint pixel coordinates, relative to the DOM element that contains the map on the page. Events Event Arguments Description addmaptype maptype Fired when a map type is added to the map using addMapType(). removemaptype maptype Fired when a map type is removed from the map using removeMapType(). click overlay, latlng Fired when the map is clicked with the mouse. If the click is on a GOverlay object such as a marker, the overlay is passed to the event handler through the overlay argument and the overlay’s click event is fired. If no overlay is clicked, the GLatLng location of the click is passed in the latlng argument. movestart Fired when the map tiles begin to move. This will fire when dragging the map with the mouse, in which case a dragstart is also fired, or by invoking the movement using one of the GMap methods. move Fired while the map is moving. This event may fire repeatedly as the map moves. moveend Fired when the map stops moving. zoomend oldLevel, newLevel Fired when the map reaches a new zoom level. maptypechanged Fired when another map type is selected. infowindowopen Fired when the info window opens. APPENDIX B ■ GOOGLE MAPS API 327 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 327 Event Arguments Description infowindowclose Fired when the info window closes. If a currently open info window is reopened at a different point using another call to openInfoWindow*(), then infowindowclose will fire first. addoverlay overlay Fired when an overlay is added using addOverlay(). The overlay is passed to the event handler. removeoverlay overlay Fired when a single overlay is removed by the method removeOverlay(). The overlay that was removed is passed as an argument to the event handler. clearoverlays Fired when all overlays are removed by clearOverlays(). mouseover latlng Fired when the mouse moves into the map from outside the map. A GLatLng location is passed to the event handler. mouseout latlng Fired when the user moves the mouse off the map. A GLatLng location is passed to the event handler. mousemove latlng Fired when the user moves the mouse inside the map. This event is repeatedly fired while the user moves around the map. A GLatLng location is passed to the event handler. dragstart Fired when the user starts dragging the map. drag Repeatedly fired while the user drags the map. dragend Fired when the user stops dragging the map. load Fired when everything on the map has loaded, with the exception of the image tiles, which load asynchronously. class GMapOptions The GMapOptions class, instantiated as an object literal, is used to provide optional arguments to the GMap class constructor. GMapOptions Properties Property Type Description size GSize Sets the size of the map container. If the container is of a different size, the container will be resized to the given GSize. If no size is passed, the map will assume the current size of the container. mapTypes Array of GMapType Array of GMapType constants to allow for the map. If no mapTypes are defined, the constant G_DEFAULT_MAP_TYPES is used. See also GMap2.addMapType(). enum GMapPane As discussed in Chapter 9, the GMapPane constants define the various layers of the map used to place overlays and their complementary icons and shadows. APPENDIX B ■ GOOGLE MAPS API328 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 328 GMapPane Constants Constant Description G_MAP_MAP_PANE The bottom layer, directly on top of the map. Used to hold overlays such as polylines. G_MAP_MARKER_SHADOW_PANE The pane containing the shadow of the markers. Lies directly beneath the markers. G_MAP_MARKER_PANE The pane containing the markers. G_MAP_FLOAT_SHADOW_PANE The pane containing the shadow of the info window. It lies above the G_MAP_MARKER_PANE to allow the markers to appear in the shadow of the info window. G_MAP_MARKER_MOUSE_TARGET_PANE The pane that holds transparent objects that react to the DOM mouse events registered on the overlays. It lies above the G_MAP_FLOAT_SHADOW_PANE to allow all the markers on the map to be clickable, even if they lie in the shadow of the info window. G_MAP_FLOAT_PANE The topmost layer. This pane contains any overlays that appear above all others but under the controls, such as the info window. class GKeyboardHandler You can instantiate a GKeyboardHandler to add your own keyboard bindings to a map. GKeyboardHandler Bindings Key Action Description up, down, left, right Continuously moves the map while the key is pressed. If two nonopposing keys are pressed simultaneously, the map will move diagonally. page down, page up, home, end Triggers an animated pan by three-quarters of the height or width in the corresponding direction. +, - Adjusts the zoom level of the map by one level closer (+) or farther away (-). GKeyboardHandler Constructor Constructor Description GKeyboardHandler(map) Creates a keyboard event handler for the given map. interface GOverlay As discussed in detail in Chapters 7 and 9, the GOverlay interface is implemented by the GMarker, GPolyline, and GInfoWindow classes, as well as any custom overlays you create. The GOverlay instance must be attached to the map using the GMap2.addOverlay() method. Upon addition, the map will call the GOverlay.initialize() method. Whenever the map display changes, the map will call GOverlay.redraw(). APPENDIX B ■ GOOGLE MAPS API 329 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 329 GOverlay Constructor Constructor Description GOverlay() Creates the default implementation of the GOverlay methods and should be used when inheriting from the class. GOverlay Static Method Static Method Returns Description getZIndex(latitude) Number Returns the CSS z-index value for the given latitude. By default, overlays that are farther south have higher z-index values, so that the overlays will appear stacked when close together. GOverlay Abstract Methods Method Returns Description initialize(map) Called by GMap2.addOverlay() so the overlay can draw itself into the various panes of the map. remove() Called by GMap2.removeOverlay() and GMap2.clearOverlays(). The overlay should use this method to remove itself from the map. copy() GOverlay Returns an uninitialized copy of itself. redraw(force) Called when the map display changes. force will be true only if the zoom level or the pixel offset of the map view has changed. class GInfoWindow GInfoWindow is always created by the GMap or GMarker class and accessed by their methods. GInfoWindow Methods Method Returns Description selectTab(index) Selects the tab with the given index. hide() Makes the info window invisible but does not remove it from the map. show() Makes the info window visible if it’s currently invisible. isHidden() Boolean Returns true if the info window is hidden or closed. reset(latlng, tabs, size, Resets the state of the info window to the given [offset], [selectedTab]) arguments. If the argument value is null, that item will maintain its current value. getPoint() GLatLng Returns the geographical point at which the info window is anchored. The default info window points to this point, modulo the pixel offset. getPixelOffset() GSize Returns the offset, in pixels, of the tip of the info window from the anchor point. getSelectedTab() Number Returns the index of the selected tab. The first left- most tab is index 0. APPENDIX B ■ GOOGLE MAPS API330 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 330 GInfoWindow Event Event Arguments Description closeclick Fired when the info window’s close button (X) is clicked. class GInfoWindowTab Instances of GInfoWindowTab are passed as an array to the tabs argument of GMap2. openInfoWindowTabs(), GMap2.openInfoWindowTabsHtml(), GMarker.openInfoWindowTabs(), and GMarker.openInfoWindowTabsHtml(). GInfoWindowTab Constructor Constructor Description GInfoWindowTab(label, content) Creates a tab object that can be passed to the tabs argu- ment for all openInfoWindowTabs*() methods. The label is the text that appears on the tab. The content can be either an HTML string or a DOM node, depending on which openInfoWindowTabs*() method you plan to use. class GInfoWindowOptions The GInfoWindowOptions class, instantiated as an object literal, is used to provide optional arguments for the GMap and GMarker methods: openInfoWindow(), openInfoWindowHtml(), openInfoWindowTabs(), openInfoWindowTabsHtml(), and showMapBlowup(). GInfoWindowOptions Properties Property Type Description selectedTab Number Sets the window to open at the given tab. The first leftmost tab is index 0. By default, the window will open on tab 0. maxWidth Number Maximum width, in pixels, of the info window content. onOpenFn Function Called after the info window has finished opening and the content is displayed. onCloseFn Function Called when the info window has been closed. zoomLevel Number Applies only when using showMapBlowup(). The zoom level of the blowup map in the info window. mapType GMapType Applies only when using showMapBlowup(). The map type of the blowup map in the info window. class GMarker An instance of the GMarker class is used to mark a geographical location on a map. It implements the GOverlay interface and is added to the map using the GMap2.addOverlay() method. APPENDIX B ■ GOOGLE MAPS API 331 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 331 GMarker Constructor Constructor Description GMarker(latlng, [opts]) Creates a new marker at the given GLatLng with optional arguments specified by GMarkerOptions. GMarker Methods Method Returns Description openInfoWindow Opens the info window over the icon of the marker. (content, [opts]) The content of the info window must be defined using a DOM node. Optional arguments are passed using the GInfoWindowOptions class. openInfoWindowHtml Opens the info window over the icon of the marker. (content, [opts]) The content of the info window must be defined using a string of HTML. Optional arguments are passed using the GInfoWindowOptions class. openInfoWindowTabs Opens the tabbed info window over the icon of the (tabs, [opts]) marker. The content of the info window must be defined as an array of GInfoWindowTab instances that contain the tab content as DOM nodes. Optional arguments are passed using the GInfoWindowOptions class. openInfoWindowTabsHtml Opens the tabbed info window over the icon of the (tabs, [opts]) marker. The content of the info window must be defined as an array of GInfoWindowTab instances that contain the tab content as a string of HTML. Optional arguments are passed using the GInfoWindowOptions class. showMapBlowup([opts]) Opens the info window over the icon of the marker. The content of the info window becomes a close-up of the area around the info window’s anchor. Optional arguments are passed using the GInfoWindowOptions class. getIcon() GIcon Returns the GIcon associated with this marker as defined in the constructor. getPoint() GLatLng Returns the GLatLng geographical coordinates of the marker’s anchor. The anchor is set by the constructor or modified by setPoint(). setPoint(latlng) Sets the geographical coordinates of the marker’s anchor to the given GLatLng instance. GMarker Events Event Arguments Description click Fired when the marker is clicked with the mouse. The GMap’s click event will also fire with the marker passed as the overlay argument. dblclick Fired when the marker icon is double-clicked. mousedown Fired when the DOM mousedown event is fired on the marker icon. APPENDIX B ■ GOOGLE MAPS API332 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 332 Event Arguments Description mouseup Fired for the DOM mouseup on the marker. mouseover Fired when the mouse moves into the area of the marker icon. mouseout Fired when the mouse moves out of the area of the marker icon. infowindowopen Fired when the info window of the map is opened using one of the GMarker info window methods. infowindowclose Fired when the info window, opened using GMarker.OpenInfoWindow*(), is closed or if the info window is opened on another marker. remove Fired when the marker is removed from the map. class GMarkerOptions The GMarkerOptions class, instantiated as an object literal, is used to provide optional argu- ments for the GMarker class. GMarkerOptions Properties Property Type Description icon GIcon An instance of the GIcon class. If not specified, G_DEFAULT_ICON is used. clickable Boolean If set to false, the marker becomes inert and consumes fewer resources. Inert markers will not respond to any events. By default, this option is true and markers are clickable. title String The title will appear as a tool tip on the marker, like the title attribute on HTML elements. class GPolyline If available, the GPolyline class draws a polyline on the map using the browser’s built-in vector- drawing facilities. Otherwise, the polyline is drawn using an image from Google servers. GPolyline Constructor Constructor Description GPolyline(points, [color], Creates a polyline from the array of GLatLng instances. Option- [weight], [opacity]) ally, the color of the line can be defined as a string in the hexa- decimal format RRGGBB; the weight can be defined in pixels; and the opacity can be defined as a number between 0 and 1, where 0 is transparent and 1 is opaque. GPolyline Methods Method Returns Description getVertexCount() Number Returns the number of vertices in the polyline. getVertex(index) GLatLng Returns the vertex with the given index in the polyline starting at 0 for the first vertex. APPENDIX B ■ GOOGLE MAPS API 333 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 333 GPolyline Event Event Arguments Description remove Fired when the polyline is removed from the map. class GIcon The GIcon class specifies the image to display as the icon for the GMarker on the map. If no icon is specified, G_DEFAULT_ICON is used. GIcon Constructor Constructor Description GIcon([copy], [image]) Creates a new GIcon object. Existing GIcon’s properties can be copied by passing the existing icon into the copy argument. The optional image argument can be used as a shortcut to the image property. GIcon Constant Constant Description G_DEFAULT_ICON The default icon used by markers. GIcon Properties Property Type Description image String URL for the foreground image. shadow String URL for the shadow image. iconSize GSize The pixel size of the foreground image. shadowSize GSize The pixel size of the shadow image. iconAnchor GPoint The pixel coordinates of the image’s anchor relative to the top-left corner of the image. infoWindowAnchor GPoint The pixel coordinates of the point where the info window will be anchored, relative to the top-left corner of the image. printImage String URL of the foreground image used for printed maps. It must be the same size as the image property. mozPrintImage String The URL of the foreground icon image used for printed maps in Firefox/Mozilla. It must be the same size as the image property. printShadow String The URL of the shadow image used for printed maps. Most browsers can’t accurately print PNG transparency, so this property should be a GIF. APPENDIX B ■ GOOGLE MAPS API334 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 334 Property Type Description transparent String Used to represent the clickable part of the icon in Internet Explorer. This should be a URL to a 24-bit PNG version of the main icon image with 1% opacity and the same shape and size as the image property. imageMap Array of Used to represent the clickable part of the icon in browsers numbers other than Internet Explorer. This should be an array of integers representing the X/Y coordinates of the clickable image area. class GPoint In version 1 of the API, a GPoint represented a geographical latitude and longitude. In version 2 of the API, a GPoint represents a point on the map by its pixel coordinates. Now, for geographi- cal latitude and longitude, see the GLatLng class. Unlike regular HTML DOM elements, the map coordinates increase to the left and down, so the X coordinate increases as objects are farther west, and the Y coordinate increases as objects are farther south. ■Note Although the x and y properties are accessible and modifiable, Google recommends you always create a new GPoint instance and avoid modifying an existing one. GPoint Constructor Constructor Description GPoint(x, y) Creates a GPoint object. GPoint Properties Property Type Description x Number X coordinate, increases to the left. y Number Y coordinate, increases downwards. GPoint Methods Method Returns Description equals(other) Boolean Returns true if the other given GPoint has equal coordinates. toString() String Returns a string that contains the X and Y coordinates, separated by a comma and surrounded by parentheses, in the form (x,y). class GSize A GSize is a width and height definition, in pixels, of a rectangular area on the map. Note that although the width and height properties are accessible and modifiable, Google recommends that you always create a new GSize instance and avoid modifying an existing one. APPENDIX B ■ GOOGLE MAPS API 335 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 335 GSize Constructor Constructor Description GSize(width, height) Creates a GSize object. GSize Properties Property Type Description width Number The width in pixels. height Number The height in pixels. GSize Methods Method Returns Description equals(other) Boolean Returns true if the other given GSize has exactly equal components. toString() String Returns a string that contains the width and height coordi- nates, separated by a comma and surrounded by parentheses, in the form (width,height). class GBounds A GBounds instance represents a rectangular area of the map in pixel coordinates. The GLatLngBounds class represents a rectangle in geographical coordinates. GBounds Constructor Constructor Description GBounds(points) Constructs a rectangle that contains all the given points in the points array. GBounds Properties Property Type Description minX Number The X coordinate of the left edge of the rectangle. minY Number The Y coordinate of the top edge of the rectangle. maxX Number The X coordinate of the right edge of the rectangle. maxY Number The Y coordinate of the bottom edge of the rectangle. GBounds Methods Method Returns Description toString() String Returns a string containing the northwest and the southeast corners of the area separated by a comma, surrounded by parentheses, in the form (nw,se). min() GPoint The point at the upper-left corner of the box. APPENDIX B ■ GOOGLE MAPS API336 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 336 [...]... method, 108 arrays, 26–27, 108 ASR (Antenna Structure Registration) database (FCC), 97 100 , 102 , 104 , 110 112, 145 atan, 262 atan2() method, 262 Azimuthal projections, 240 ■ B background images, overlay, 169, 172, 175 Beginning Ajax with PHP: From Novice to Professional (Babin), 59 Beginning PHP and MySQL 5: From Novice to Professional (Gilmore), 102 Behaviour library, 128 BETWEEN clause, 309, 311 blog, googlemapsbook,... a control with buttons to pan in four directions, and zoom in and zoom out GLargeMapControl() Creates a control with buttons to pan in four directions, and zoom in and zoom out, and a zoom slider GSmallZoomControl() Creates a control with buttons to zoom in and zoom out GScaleControl() Creates a control that displays the map scale GMapTypeControl() Creates a control with buttons to switch between map... windows /maps, 46, 120–121, 129–130 sort file system utility (Unix), 102 soundex() function, 309 space-related data, 247–248, 253, 321, 322 spheres calculating area on, 261–262, 269–273 calculating distances on, 83, 266–267 SQL See also MySQL; PostgreSQL combining data from, 106 107 data storage in, 52 importing data into, 102 , 111 retrieving data from, 52, 106 – 110 syntax, 102 , 108 , 109 – 110 views, 106 , 110 111... class, 333 GMercatorProjection class, 242–243, 344–345 Golden Gate Bridge location, 16 Google AJAX Search API, 201 Google Earth, 203 Google JavaScript Geocoder, 74–75 Google Maps described, 31 history, 3 limitations, 145–146 Google Maps API classes, 323–331, 333–349 functions, 349–350 JavaScript and, 48 reference, online, 16 terms of use, 13 Google Maps API Geocoder about, 67–68 accessing from JavaScript... 278–280 debugging within, 209– 210 discussion group, 199 documentation, 259 Enterprise edition, 200, 204 improvements, future, 199–205 map, interacting with, 31, 146, 210 214 requests, 73–74 responses, 68–74 terms of service, 204 version differences, 199 Google Maps web applications, 13 Google Mini search appliance, 204 Google search, 316 Google services, 200–201 Google Sightseeing, 202–203 Google SketchUp... to deregister the handler with GEvent.removeListener() When referencing 'this' from within the supplied handler function, 'this' will refer to the JavaScript object supplied in the first argument addDomListener (dom, event, handler) GEventListener Registers an event handler for the event on the DOM object Returns the GEventListener handle that can be used to deregister the handler with GEvent.removeListener()... need to register and trigger event listeners on objects and DOM elements The events defined by the Google Maps API are all custom events and are fired internally using GEvent.triggerEvent() GEvent Static Methods Static Method Returns Description addListener (object, event, handler) GEventListener Registers an event handler for the event on the object Returns the GEventListener handle that can be used to. .. G_ANCHOR_TOP_RIGHT Anchored in the top-right corner of the map G_ANCHOR_TOP_LEFT Anchored in the top-left corner of the map G_ANCHOR_BOTTOM_RIGHT Anchored in the bottom-right corner of the map G_ANCHOR_BOTTOM_LEFT Anchored in the bottom-left corner of the map class GMapType As discussed in Chapter 9, the GMapType is the grouping of a map projection and tile layers GMapType Constructor Constructor Description... referencing external API from, 19 separating from Cascading Style Sheets, 18 hurricanes, data on, 320 hybrid maps, 237 ■ I icons, 59, 61–62, 220–223 See also GIcon class ImageMagick, 250–251 images background, 169, 172, 175 preparing for display, 249 preslicing, 246, 249–250 of /from space, 247–248, 253, 321 implode() method (PHP) , 108 import scripts, protecting, 102 importing data, 101 102 , 104 , 111, 117, 139... plotting, 22, 26, 27, 59–62 retrieving from server, 57–59 saving information on, 26, 27, 45, 49–52 tracking, 196–197 mashup, term, 10 Math objects, resources for, 269 maximizing maps, 120–121 maxResolution() method, 246 memory management, 20, 102 , 108 109 Mercator projections See also GMercatorProjection class distortion caused by, 239, 241–242, 267 map wrapping and, 154 mathematical formulas, 172, 177, . control with buttons to pan in four directions, and zoom in and zoom out. GLargeMapControl() Creates a control with buttons to pan in four directions, and zoom in and zoom out, and a zoom slider. GSmallZoomControl(). slider. GSmallZoomControl() Creates a control with buttons to zoom in and zoom out. GScaleControl() Creates a control that displays the map scale. GMapTypeControl() Creates a control with buttons to switch between map. B ■ GOOGLE MAPS API344 7079chAppBFINAL.qxd 7/26/06 5:05 PM Page 344 GMercatorProjection Methods Method Returns Description fromLatLngToPixel GPoint See GProjection. (latlng, zoom) fromPixelToLatLng