MapPIN'on OSM(http://mappin.hp2.jp/ ) is "Mapping Photo Introducing Network on OpenStreetMap". The website provides index of locations of geotagged photos and shows them on OpenStreetMap. This web server itself doesn't hold any photos. Those photos shown on the map are published somewhere in Internet and they are just linked to "MapPIN'on OSM" by RSSes which the photo's authors provided. So to speak, MapPIN'on OSM is a kind of RSS reader. The real aim of this projects is exciting remote mapping. The site owner is one of OSM contributors, Nazotoko. Now the state is beta released (test and correction state). The data itself is stable. Anyone can join it.
Geotagged photos are powerful data sources
To map something, we need to gather information of where it is and what it is at the same time. (see Mapping techniques.) Aerial photos and GPS tracks give us where it is, however, those are hard to show what for the other people. Ground surveyors write notes on their notepad or take photos to recode the what they are. Then when they get back home, they start to link the notes and photos with the GPS logs and they can start to draw map according to those material.
Then, here is a question. Those linked notes and photos have got what and where at the same time. If someone give us such great materials, can we start to draw map without surveying there? The answer is YES! and many people who are not contributors of OSM have such great materials. Those are called as "geotagged photos". MapPIN'on OSM project is correcting a lot of geotagged photos, which are usable for mapping, (I call them "Mapping photos") and introducing to OpenStreetMap contributors.
The Mapping Photo Introducing Network
- Connection 1
Some of OSM mappers already know the geotagged photos are powerful sources. So they may geotag their photos. Some GPS users have already geotagged their photos. They upload such photos to somewhere in internet. Such sites are called as web photo albums or photo blogs.
- Connection 2
If this connection were strong, MapPIN'on OSM would not be needed. Unfortunately, those photo blog site doesn't give any information to OSM, actively. They have searching functions with location though, those searching function just answer a few photos of thousands of photos. The worst thing is that their map is copyrighted. We cannot distinguish the geotagged point information are come from GPS or copyrighted map, just using the photo blog sites.
- Connection 3
Then, MapPIN'on OSM is needed to select the copy-licensed geotagged photos. First of all, photo owners must register their photo blog site by a URL of RSS of their site. MapPIN'on OSM never collect photos information without owners' agreement. Next, a background server download the RSSes and the photos listed on the RSSes from their blog sites. From those files, it makes a list of locations, links, and possibilities of copyrighted geotags for each photos. How to distinguish the possibility is explained later.
- Connection 4
The list of photos are divided to tiles (call photo marker tiles) by the location data. Those tiles are uploaded to foreground server ( http://mappin.hp2.jp/ ), the foreground server is just a HTTP server. When someone accesses the foreground server by his browser, it read index.html and shows a Slippy Map using OSM living tile with overlay of the photo marker tiles.
- Connection 5
Photo markers are coloured by the possibility of copyrighted geotags. Any coloured markers must have latitude, longitude and link to the original photo blog. Link-backing is a social rule. Legally, RSSes are usually licensed by Creative Commons Attribution somewhat, too.
- Connection 6
How to use
Browsing it is a fast way to learn it. The map uses OpenLayers which is the same with Slippy Map. You may be familiar with zooming and panning the map to see somewhere you want. When the zoom level is over 10, this map try to read a photo marker tile at the centre. Each photo marker tiles is a 2x2 minute square. If there are some photos in the area, their locations are shown as markers. The meaning of those colours are explained later.
Some of you will realize that the interface is very similar to OpenStreetBugs. Yes, this site's interface part is derived from OpenStreetBugs and the controls are not so changed.
When you hover the mouse pointer on a marker, a tip pops up on it. The tip shows a thumbnail, location information, and some links related with the original photos. The links means as the follows:
- link: The publishing page of the photo. It comes from RSS's <link> tag.
- original (or large) photo: This is the direct link to the photo jpeg file. MapPIN'on OSM plugin for JOSM uses this link.
- RSS: This is a link to a listing page that the RSS of this photo specifies.
- embed: making permanent link to this marker.
When you move the mouse pointer out from the marker, the tip closes. To lock the tip, click on the marker. If you click the marker again or click on the close mark on the tip, the tip is unlocked and closed.
When you click on somewhere not placed any markers, a yellow marker comes and shows "Here is:" popup. The popup shows location information of the point that you clicked. The "mappin:at=*" shown on the popup is a short code for the location and it indicates the information comes form MapPIN'on OSM. If you tag it to one of your photo on your photo blog, MapPIN'on OSM decodes the information and places the photo marker there.
Icons' colour means the copyright safeties of the location information as shown in the following table.
|blue||The location is geotagged in JPEG EXIF, it looks to be tagged from a GPS log or OSM. It means the information of the location would not come from copyrighted map, so you may import it into OpenStreetMap.|
|yellow||The photo JPEG file doesn't have EXIF geotag. The location information comes from georss. Georss information are provided from web photo album site or photo blog site. Their sites usually use google map and yahoo. So the location information is suspected to be copyrighted, but don't give up, you should go to the photo site once. If the site is Flickr and the photo's location is in the area using OpenStreetMap, (Baghdad, Beijing, Kabul, Sydney, Tokyo,...), the location is not copyrighted at all. Even if it is not OpenStreetMap, the location shows on completely white area(no road, no landscape), it would be tagged by using author's GPS.|
|red||The location is geotagged in JPEG EXIF, but it is tagged by Picasa. Picasa is a software provided from google. This software has a bug to reduce the resolution of geotagged location and a function geotaging by using Google Map (of course, it is a copyrighted map). So I never recommend to import the location into OpenStreetMap. Use the photo just to see.|
Editing OSM with the photo
When the marker colour is blue, or yellow but you are sure that it is copyright safe, you can edit OpenStreetMap with it. You can see a menu item "edit map" on the top of the map. The submenu leads you to start to edit around there. MapPIN'on OSM supports Potlatch by Photo KML and JOSM by a plugin.
If you use Potlatch, set http://mappin.hp2.jp/kml.php to a box of photo KML. See the detail is a blog article "MapPIN'on Potlatch".  After setting it, click camera icon at the bottom of Potlatch panel. The photo markers are loaded and film icons are appears. The KML provides only blue markers.
If you use JOSM, install MapPIN'on OSM plugin first.
Before you start to edit, you should get which direction the camera faced to when the photo was taken. If your camera has a compass and can tag GPSImgDirection, MapPIN'on OSM shows the direction and area.  Unfortunately, such functionable cameras are very rare. Ordinarily, some kind of landmark may be taken into photo, for example, a straight road, a high building, a lighthouse, a mountain, a valley or a coastline. Find the landmark on OSM. MapPIN'on OSM also provide the function to show contour lines (this is public domain source), so you can also find a mountain from it. From the landmark, you may get directions and scale, so you can map anything shown in the photo. Even if you get any landmarks, if you can see some shadow of the Sun, you can get the direction by calculating from longitude and the photo's taken time, which is recoded on EXIF tag.
Before finishing editing, Do NOT forget to tag source=* to mapped features. The linking URL should be the URL shown as "link" in the popuped tip. This tagging is very important for 2 reasons.
- All mapping feature should be verified by some existing evidences. This is like abundant number of citations on Wikipedia. We should map only verifiable features to prevent form mapping unreal things, Copyright Easter Eggs, too.
- Because linking back to the original is a requirement of the photo's or the RSS'es license. Usually both of them are provided under the Creative Commons Attribution somewhat.
This is not required but socially better to comment "Thank you" to the original photo author's blog, when you use it to draw a map feature. Here is a example in English.
|Thank you. Your photo is useful for OpenStreetMap. I have used your photo to map a feature. The feature is <a href="http://osm.org/browse/way/xxxxxxxxx">XXXXX Street</a>. If you would like to, you can tag "osm:way=xxxxxxxxx" to this photo.|
|For translators of this wiki: Please translate this table first, because the other language user of OSM would like to read this to comment to author's page of other language speaker.|
If the photo author's blog cannot use HTML markup, you don't need to write "<a href="...">. The "xxxxxxxxx" is osm id number. "osm:way=xxxxxxxxx" is flickr's machine tag, so it is nonsense for general photo blogs. However MapPIN'on OSM reads and stores the machine tags and there is a plan to show the OSM features specified by the machine tags on MapPIN'on OSM.
How to provide your photos
In order to make your photos to be placed on MapPIN'on OSM, you need to add location information to your photos, there are 3 ways.
- Tag GPS tag in EXIF. If your camera has GPS, your camera do it. Without it, you need GPS logs and a software to edit EXIF. See Geotagging Source Photos for detail.
- Upload your photo first. Tag mappin:at=* tag shown in "Here is" popup of MapPIN'on OSM.
- If your photo blog provides georss, it must have some function to add location point. Please try to find a function tagging by input the latitude and longitude read from GPS or OSM, not by copyrighted maps.
Your photo blog may provide auto-generated RSSes. Find the URL of the RSS and register it to Registration form.
Caution: Picasa's bug
Picasa is a software provided by google. It usually use google map and it doesn't allow us to edit EXIF GPS tag by direct input of latitudes and longitudes. Thus, MapPIN'on OSM deals Picasa's editing EXIFes as copyrighted information.
However, I have found another case that Picasa edits EXIFes. It happens when you rotate your photo in picasaweb, and it has fatal bug, reducing precision of coordinates of original EXIF GPS tag. It is a known bug, but google has not fixed: 
Here is a case of my photo.
|Original||modified by Picasa|
EXIF tags in 'IMG_0992.JPG' ('Motorola' byte order): --------------------+------------------------------- Tag |Value --------------------+------------------------------- Manufacturer |Apple Model |iPhone Orientation |bottom - right Resolution Unit |Inch Date and Time |2008:11:30 07:14:30 Software |DIGICAM PLUGIN for KASHMIR3D Compression |JPEG compression Orientation |bottom - right Resolution Unit |Inch FNumber |f/2.8 Date and Time (origi|2008:11:30 07:14:30 Date and Time (digit|2008:11:30 07:14:30 Color Space |sRGB PixelXDimension |1600 PixelYDimension |1200 Gamma |2.20 GPS tag version |0x02, 0x00, 0x00, 0x00 North or South Latit|N Latitude |36.00, 27.47, 0.00 East or West Longitu|W Longitude |116.00, 51.89, 0.00 Altitude reference |0x00 Altitude |0.00 --------------------+---------------------------- EXIF data contains a thumbnail (12858 bytes).
EXIF tags in 'IMG_0992.JPG' ('Intel' byte order): --------------------+---------------------------- Tag |Value --------------------+---------------------------- Manufacturer |Apple Model |iPhone Orientation | Resolution Unit |Inch Date and Time |2008:11:30 07:14:30 Software |Picasa 3.0 Compression |JPEG compression x-Resolution |72.00 y-Resolution |72.00 Resolution Unit |Inch FNumber |f/2.8 Date and Time (origi|2008:11:30 07:14:30 Date and Time (digit|2008:11:30 07:14:30 Color Space |Uncalibrated PixelXDimension |1600 PixelYDimension |1200 Gamma |2.20 Image Unique ID |9d9a64f83ee9441565879f74b2d754a0 GPS tag version |0x00, 0x00, 0x02, 0x02 North or South Latit|N Latitude |36.00, 27.00, 0.00 East or West Longitu|W Longitude |116.00, 51.00, 0.00 Altitude reference |0x00 Altitude |0.00 --------------------+------------------------ EXIF data contains a thumbnail (7818 bytes).
See well at Latitude and Longitude. Obviously, it cuts values less than minute unit. Strongly, I must say that Don't rotate your photo in picasaweb. Because of this fatal bug, MapPIN'on OSM never trusts EXIF when "Picasa" is found in EXIF.
- The logo.svg is a quad license, Creative Commons Attribution Sharealike, GPL, LGPL and Mozilla Public License.
- Background server: BSD-style license, (Attribution, NO warranty)
- Source codes: http://github.com/nazotoko/MapPINon_OSM
- Bug reports and wish lists: http://github.com/nazotoko/MapPINon_OSM/issues
- Message Translation: http://github.com/nazotoko/MapPINon_OSM/blob/master/material/en.xml
- Translate this xml file and contact nazotoko to integrate it.
- Javadocs: (not ready)
- Photo mapping
- JOSM/Plugins/MapPIN'on OSM
- Show Your Places