My favorites ▼ | Sign in
Project Home Downloads Wiki Issues Source
Summary   People
Project Information
Members
Featured
Wiki pages
Links

NOTE: THIS CLASS IS NOT SPONSORED BY OR AFFILIATED WITH GOOGLE

The world of building web applications that utilize Google Maps can be a tedious and laborious process. The intent of this class is to make it easier for developers to quickly and easily integrate a map into their page with very little effort.

This project was born from the PHP GoogleMapAPI from Monte Ohrt, and I consider this to be an updated "revision" to the original. This class is released under the same license as the original to avoid any conflicts.

I welcome any feedback, feature requests, problems, and suggestions and will do my best to keep this up to date as the latest V3 Google API offerings are released. With that said, I would also suggest working directly from SVN, and any necessary modifications done in subclasses (I've left everything in the class "public" for that reason); I say this because Google has announced that with the latest version (3), currently they are not maintaining separate versions, if you are using V3, it is currently always the latest stable version from Google. If this changes in the future, I will update the class accordingly

For anyone that might have implemented previous revisions, here is an "in-progress" changelog from V2.5

Stay up to date and connect with us on Twitter or Facebook.

New Features in 3.0

  • Updated to use Google Maps API v3
  • Removed references and everything dealing with Google Maps API key since API keys are no longer necessary in V3 of the API!
  • Updated geocaching to use new Google Maps V3 geocoder.
  • Updated marker/custom icon handling.
  • Added ability to create maps for mobile devices.(iPhone and Android devices are currently the only supported devices)
  • Added directions rendering
  • Added walking and biking directions support
  • Added JSMin minification support.
    • Note - this means that in order to leave $_minify_js set to true (default), you must include JSMin.php as well. I have included a copy of this library in the repository.
  • Added addPolylineByCoordsArray and addPolylineByAddressArray methods
  • Added Elevation Chart display support.
    • Display multiple elevation charts for a map (and even multiple maps/charts per page)
    • Choose whether or not to display a correspondingly located marker on the line (directions or polyline) when hovering over a location on the elevation chart. (see demos below)
  • Added Multiple Map Support
    • Now you can easily add more than one map to the same page.
    • See the example below for more details.
  • Added addMarkerOpener function to create custom marker openers
    • The function takes a marker id (returned from add marker) and dom object id and then attaches an onclick (or onmouseover if you've switched the default action) to the given object and opens the marker's info window.
  • Added Traffic Overlay and Bike Map Overlay support. See the examples below.
  • Added Custom Overlay support with opacity option
  • Added KML Overlay support - add KML/GeoRSS files utilizing the client side JS calls.
    • Simply pass in a filename to any KML or GeoRSS file and you are on your way!
  • Added MarkerClusterer support.
  • Added ability to choose between buttons or dropdown for map type navigation.
  • Added street view controls support! Check out the demo to see how easy it is!
  • NEW Added support for polygon drawing

To-do/3.0 Roadmap (add any requests here)

  • Add ability to add directions with waypoints to a map.
  • Add ability to toggle various layers using nav (this is not natively supported, but it still possible, check out the layer control demo)
  • Update controls to use new API v3 methods. (will most likely involve some refactoring)
  • Add ability to create a map for user to place / move marker and post new marker location to given url.
    • Add ability to get user's location on map from GPS device.
  • Add ability to create a map for user to place / update polyline and post new polyline coords/options to given url
    • Add ability to create a polyline from mobile GPS input.
  • Add ability to create a map for user to place / update waypoints/directions and post new directions route coords/options to given url
  • Add ability to create a map with markers and/or polylines and/or directions that a user can create/edit and post to given url.
  • Add GPX/TCX Polyline import support
    • Update 05/07/2010: Google just announced today an API method for this(KML). I am working on integrating this into the class now.
    • Update 05/08/2010: I have integrated the KML/GeoRSS overlay support into the class. am still debating on support GPX/TCX at this time.

Not Currently Supported in Official V3 Google Map API but on the Radar

Add your votes to the bugs to help get some attention to these requests

Demos

NEW Street View

Elevation Charts

Map Type Controls

Markers

GeoCoding

Polylines

Directions

Mobile

  • Simple Mobile Map Example
  • NOTE Anyone of the examples listed here can easily be transformed into a "mobile" map by simply a)setting the width and height to 100% and b)set the mobile parameter = true.

Overlays

Multiple Maps
Powered by Google Project Hosting