mvexel / bingimageanalyzer

Bing Aerial Imagery Analyzer for OpenStreetMap
===========================================================================
This web page shows the default bing satellite and aerial photos overlaid with
their capture date as set in the HTTP headers for each tile. It uses a PHP proxy
script located here[1] to create the transparent date overlay tiles.
If zoomed in past zoom level 11, the page shows an approximation of the 
remaining zoom depth for each quarter tile. This is visualized using a 
semi-transparent color (greener is more remaining zoom depth) and a number.

If you want old-style overlay tiles, not showing remaining zoom depth beyond 
zoomlevel 11, use 'nodepth=1' in the query string.

There is probably some violation of the Bing terms of use, as I call the http
headers for the tiles directly, bypassing the Bing API. I see no real way around
this, but if this site stops working all of a sudden, you know why. As of 
version 0.8, the load on the server is reduced somewhat by disk-caching the 
overlay tiles when they are generated. 

[1] http://mvexel.dev.openstreetmap.org/bing/tile.phps
===========================================================================
history:
0.1-20101202	- 	initial release.
0.2-20101202	- 	added potlatch edit link.
0.3-20101203	- 	prettified date output.
0.4-20101206	- 	added permalink button.
0.5-20101206	- 	smarter display of age ranges.
0.6-20101206	- 	added search box.
0.7-20101209	- 	added zoom depth visualization and current zoom level
0.8-20101214	- 	added caching of the generated overlay tiles
0.81-20101215	-	added OpenLayers zoom query parameter compatibility and
			nodepth parameter for old-style overlay (no zoom depth)
0.83-20101228	-	added layer opacity		
0.84-20110103	-	added TMS-style request parsing to tile.php
===========================================================================
Copyright (c) 2010 Very Furry / Martijn van Exel

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

Installation
===========================================================================
1. Edit index.html. Change the values for bingCredentials and baseURL. If
You don't have a Bing Maps API key, get one through 
http://msdn.microsoft.com/en-us/library/ff428642.aspx
2. Edit tile.php. Change thhe value for $TC_BASE to a web-accessible
directory. Optionally, enable logging to a specific file by setting 
$LOCAL_LOG 
3. Create directories 'tiles' and 'tiles_simple' in the directory you 
provided in $TC_BASE, and make them writable for the webserver.
4. Go to [baseURL]/bingimageanalyzer - should work now!