This submission is in response to this gmaps-api-flex feature request. This is a hack that provides functionality like what was requested here.
So you’ve added a custom tile layer to your Google Maps app in Flex, which lets you show all your pretty spatial features. Fantastic! If you want to make this tile layer dynamic, however, you run into a few problems. The Google Maps Flex API caches tiles that it has loaded from a specific Tile Overlay, so if your data changes, the changes won’t be reflected on your map immediately. There have been various hacks that force a refresh of the map, but they don’t completely meet the requirements set in this feature request. The attached code here is a hack that tries to mimic the requested functionality, without refreshing the entire map.
After exploring a little, I saw that one way the Flex API differentiates overlays is by the request URL. If you create an overlay, add it to the map, remove it, create a new overlay with the same URL, and add the new overlay, it will load the tiles from the internal cache. Now, this functionality can be nice if you’re switching between two different overlays, and there haven’t been any changes in the data. For instance, if an app requests tiles from the following URLs in order:
it will load both of these layers properly, and cache them both. If you then load the calicounties layer, using the same URL string, it’ll give you back the cached version.
However, if the data has changed, you’d want to reload the entire layer. To do this, I have appended a garbage GET variable to the URL. The requests will now look like:
Simply change the GARBAGE variable when loading calicounties again and it’ll load from the source.
The included code implements four events that are dispatched to/listened from the map object:
- Tell the Tile Layer to refresh (do not change the GARBAGE variable)
- Tell the Tile Layer to reload (change the GARBAGE variable)
- Refresh/Reload completed successfully (all tiles loaded)
- Implemented by incrementing a counter whenever Loader instances are created, and decrementing the counter whenever they complete/fail.
- If any loading errors occurred.
Note: You need to pass the TileLayer both the TileOverlay that holds it and the Map object, so it can handle refreshing and event dispatch by itself.
var tileLayer:MapServerTileLayer = new MapServerTileLayer(map);
var tileLayerOverlay:TileLayerOverlay = new TileLayerOverlay(tileLayer);
For an example on using MapServer/PHP MapScript with Google Maps, go to this blog post.
- Google Maps Flex API: Refresh Tile Layer
What it says!