Lately I have been playing with Google Static Maps API a lot. Writing the same things again and again is tedious job. I decided to put the code together as one clean extendable package. Writing object oriented interface for generating URL is trivial. Real meat is having working zoom and pan controls on static map
with just 9 lines of code (demo now includes also clickable markers and infowindows).
Code is still alpha quality. API might change any time. But here is a quick walkthrough of current features. We will build the map you see above step by step.
Create a Map Object
Map object is created using
Google_Maps::create('static') factory method. If no markers are set you also need to set the center of the map.
require_once 'Google/Maps.php'; $map = Google_Maps::create('static'); $map->setSize('540x300'); $map->setCenter(new Google_Maps_Coordinate('58.368488', '26.768908')); $map->setZoom(8); $map->setKey(API_KEY);
Add some markers
Location on map can be in two ways. Latitude and longitude represented by Google_Maps_Coordinate object. Or pixel x and pixel y location represented by Google_Maps_Point object. You can use both when creating a marker.
$coord_1 = new Google_Maps_Coordinate('58.378700', '26.731110'); $coord_2 = new Google_Maps_Coordinate('58.368488', '26.768908'); $coord_3 = new Google_Maps_Coordinate('58.268488', '26.768908'); $marker_1 = new Google_Maps_Marker($coord_1); $marker_2 = new Google_Maps_Marker($coord_2); $marker_3 = new Google_Maps_Marker($coord_3); $marker_1->setColor('green'); $marker_2->setColor('blue'); $marker_3->setColor('orange'); $map->setMarkers(array($marker_1, $marker_2, $marker_3));
Automatically Calculate Zoom and Center
Google Static Maps API can automatically calculate zoom and center for you. However there is no way to know what zoom level it chose. If you need to know automatically calculated zoom and center use $map->zoomToFit() method.
Here we also add new marker using pixel coordinates. Note that we also clear the center of the map we set in the beginning. This allows map to recenter the map according to markers on the map.
$point_1 = new Google_Maps_Point('308107197', '160958681'); $marker_4 = new Google_Maps_Marker($point_1); $map->setCenter(false); $map->addMarker($marker_4); $map->zoomToFit();
Show Marker Bounds
Sometimes you need to be able to visually see bounding box where all the markers fit in.
Show Map Bounds at Chosen Zoom Level
You can also calculate and show map bounds at any zoom level. Example below displays map bounds at zoom level 8. Map itself is at zoom level 7.
$map->setZoom(7); $map_bounds = $map->getBounds(8); $map->setPath($map_bounds->getPath());
Where's the Source?
If you want to play around with code you can get from github. Patches, improvements and suggestion are welcome.
git clone git://github.com/tuupola/php_google_maps.git wget http://github.com/tuupola/php_google_maps/zipball/master