Best tools for multimedia reporting Fri, 31 Oct 2014 18:57:58 +0000 en-US hourly 1 https://s0.wp.com/i/webclip.png 32 32 239681374 https://geojournalism.org/2013/08/how-to-map-photos-using-openstreetmap-and-tilemill/ Mikel Maron Wed, 14 Aug 2013 21:29:27 +0000 Maps cartography geotagging map design Open Street Map https://geojournalism.oeco.org.br/?p=268 <p>This guide takes four steps, demonstrating an overview of the whole flow and connection between four tools to build a photo map. This guide will hit the main points and highlight how the tools connect up with open data Introduction Recently, we organized a fun skill share with Map Kibera, and then again with Transparent [&#8230;]</p> <p>The post <a href="https://geojournalism.org/2013/08/how-to-map-photos-using-openstreetmap-and-tilemill/">How to Map Photos Using OpenStreetMap and TileMill</a> appeared first on <a href="https://geojournalism.org">geojournalism.org</a>.</p> <p>This guide takes four steps, demonstrating an overview of the whole flow and connection between four tools to build a photo map. This guide will hit the main points and highlight how the tools connect up with open data<span id="more-268"></span></p> <h2 class="summary-item" id="introduction"><a href="#introduction">Introduction</a></h2> <p>Recently, we organized a fun skill share with <a href="https://mapkibera.org/" rel="nofollow">Map Kibera</a>, and then again with <a href="https://www.transparentchennai.com/" rel="nofollow">Transparent Chennai</a>. The idea is to use OpenStreetMap and TileMill to create an interactive photo map. Here’s the <a href="https://a.tiles.mapbox.com/v3/groundtruth.map-vx5bbbu4/page.html" rel="nofollow">simple result</a> from working with Map Kibera.</p> <p><strong>Want to learn to create something like this?</strong> This guide takes four steps, demonstrating an overview of the whole flow and connection between four tools to build a photo map. This guide will hit the main points, highlight how the tools connect up with open data, and I’ll just link to other resources for the details on how to use each.</p> <h2 class="summary-item" id="upload-photos-to-flickr"><a href="#upload-photos-to-flickr">Upload Photos to Flickr</a></h2> <ul> <li>What you need: A photo of a place to map.</li> <li>What you get: Link to the photo page and photo preview.</li> <li>Learn more: <a href="https://www.flickr.com/help/photos/" rel="nofollow">Flickr Help</a></li> </ul> <p>If you don’t have a <a href="https://flickr.com/" rel="nofollow">Flickr</a> account, create one, it’s an easy way to share images. Upload a photo of a place. For our example, we uploaded <a href="https://www.flickr.com/photos/mikel_maron/9420814521/" rel="nofollow">this photo of the iHub in Nairobi</a>, taken during the Uchaguzi election project. We created a <a href="https://www.flickr.com/groups/2274104@N21/" rel="nofollow">Map Kibera group</a> to hold all our collective photos. <em><br/> </em></p> <div class="wp-caption aligncenter" id="attachment_664" style="width: 727px"><a href="https://geojournalism.org/wp-content/uploads/2013/08/9508348007_2c645cceeb_b.jpg"><img alt="Credit: Mikel Maron, Ground Truth Initiative" aria-describedby="caption-attachment-664" class="wp-image-664" decoding="async" fetchpriority="high" height="354" sizes="(max-width: 717px) 100vw, 717px" src="https://geojournalism.org/wp-content/uploads/2013/08/9508348007_2c645cceeb_b.jpg" srcset="https://geojournalism.org/wp-content/uploads/2013/08/9508348007_2c645cceeb_b.jpg 1024w, https://geojournalism.org/wp-content/uploads/2013/08/9508348007_2c645cceeb_b-300x148.jpg 300w" width="717"/></a><p class="wp-caption-text" id="caption-attachment-664">Credit: Mikel Maron, Ground Truth Initiative</p></div> <p><span style="font-size: 13px; line-height: 19px;">From your photo page, click the </span><strong style="font-size: 13px; line-height: 19px;">Share</strong><span style="font-size: 13px; line-height: 19px;"> button, and then the </span><strong style="font-size: 13px; line-height: 19px;">Grab the HTML/BBCode</strong><span style="font-size: 13px; line-height: 19px;"> panel. Select a “Small” image size, and copy/paste the HTML code into a text editor/word processor. We need only the image link, which is within the </span><strong style="font-size: 13px; line-height: 19px;"><img alt="" decoding="async" src="..."/></strong><span style="font-size: 13px; line-height: 19px;"> tag.</span></p> <p>The result you should have is a link to the photo page, and the photo preview. Something like:</p> <pre><code>https://www.flickr.com/photos/mikel_maron/9420814521/ https://farm4.staticflickr.com/3673/9420814521_f71924dd4e.jpg</code></pre> <h2 class="summary-item" id="edit-openstreetmap"><a href="#edit-openstreetmap">Edit OpenStreetMap</a></h2> <ul> <li>What you need: Location of your photo.</li> <li>What you get: OpenStreetMap feature linked to the image.</li> <li>Learn more: <a href="https://learnosm.org/en/" rel="nofollow">LearnOSM</a></li> </ul> <p>Now, over to <a href="https://osm.org/" rel="nofollow">OpenStreetMap</a>. Sign up if needed, and review the basics in <a href="https://learnosm.org/en/" rel="nofollow">LearnOSM</a>. Also, try the iD Walkthrough: navigate to an area, click <strong>Edit</strong> (specifically, click the down arrow, and select “Edit with iD”), and follow along the editing tutorial.</p> <p><strong>Now</strong> open the <strong>View</strong> tab again. Enter the name of the location of your photo, and search. In our case, it’s “iHub”. Look through the search results, and find the correct feature, <em>there might be more than one feature with that name</em>, and then click <strong>View Details</strong> to open the <a href="https://www.openstreetmap.org/browse/node/673988331" rel="nofollow">browse page for that node</a>. This page shows the location and tags for the feature, and in the lower right, click the <strong>Edit Node</strong> link.</p> <p><em>Often you’ll need to add a new feature in OSM, rather than add to an existing feature. Check out the other guides to learn more.</em></p> <div class="wp-caption aligncenter" id="attachment_651" style="width: 727px"><a href="https://geojournalism.org/wp-content/uploads/2013/08/9511330104_a4bdec07e4_b.jpg"><img alt="Credit: Mike Maron" aria-describedby="caption-attachment-651" class="wp-image-651" decoding="async" height="365" sizes="(max-width: 717px) 100vw, 717px" src="https://geojournalism.org/wp-content/uploads/2013/08/9511330104_a4bdec07e4_b.jpg" srcset="https://geojournalism.org/wp-content/uploads/2013/08/9511330104_a4bdec07e4_b.jpg 1024w, https://geojournalism.org/wp-content/uploads/2013/08/9511330104_a4bdec07e4_b-300x152.jpg 300w" width="717"/></a><p class="wp-caption-text" id="caption-attachment-651">Credit: Mike Maron</p></div> <p>In the left panel, click All tags, then the +, to add the tags to link the image on flickr. Add “image”, then the link to the Flickr photo page. It will look like:</p> <pre> image=https://www.flickr.com/photos/mikel_maron/9420814521/</pre> <p>Click <strong>Save</strong>, add a commit message, and click <strong>Save</strong> again.</p> <p><strong>Caveats</strong></p> <p>Important: When you are taking photos, make sure to record which photo goes with which object! It can get confusing if there’s a lot.</p> <h2 class="summary-item" id="extraction-with-overpass-turbo"><a href="#extraction-with-overpass-turbo">Extraction with Overpass Turbo</a></h2> <ul> <li> What you need: A Deep Breath (take one now!)</li> <li>What you get: A GeoJSON file containing images and locations.</li> <li>Learn more: Overpass Turbo wiki page</li> </ul> <p>The OpenStreetMap website presents one view of the data you contribute. The powerful thing about OSM is that you can take the data and use it however you like. Extracting the data from OSM itself, for use in another tool, is what this step is about.</p> <div class="wp-caption aligncenter" id="attachment_652" style="width: 727px"><a href="https://geojournalism.org/wp-content/uploads/2013/08/9508838929_56cae156ed_b.jpg"><img alt="Credit: MIke Maron" aria-describedby="caption-attachment-652" class="wp-image-652" decoding="async" height="365" sizes="(max-width: 717px) 100vw, 717px" src="https://geojournalism.org/wp-content/uploads/2013/08/9508838929_56cae156ed_b.jpg" srcset="https://geojournalism.org/wp-content/uploads/2013/08/9508838929_56cae156ed_b.jpg 1024w, https://geojournalism.org/wp-content/uploads/2013/08/9508838929_56cae156ed_b-300x152.jpg 300w" width="717"/></a><p class="wp-caption-text" id="caption-attachment-652">Credit: MIke Maron</p></div> <p>Open <a href="https://overpass-turbo.eu/?key=image&amp;template=key-type&amp;type=node" target="_blank">Overpass Turbo</a> with the template to search for nodes with key “image”. <em>You can find links for other tags by exploring <a href="https://taginfo.openstreetmap.org/" target="_blank">TagInfo</a>, another great tool I’ll cover in a later skill share.</em> The interface has two panels, on the left the “Query” and the right the “Map”. Search and navigate the map to the area where your features are located. For us, the is “Nairobi”.</p> <p>The query to do the extraction can get complicated; you’ll see the template settings on the left, looking something like.</p> <pre>{{key=image}} {{type=node}}</pre> <p>Now click <strong>Run</strong>. Overpass will work for a few seconds, and then display the results on the map. You can click the points to get more info on each feature. Now click the <strong>Export</strong> menu, then the <strong>Data</strong> panel, and finally <strong>GeoJSON</strong>. This should trigger a download of the results, and a display of the results in the dialog (some browsers won’t automatically download, so copy/paste the GeoJSON from the dialog into a file, and save locally). Note the location of the GeoJSON file, we need it for the next step.</p> <h2 class="summary-item" id="groom-geojson"><a href="#groom-geojson">Groom GeoJSON</a></h2> <ul> <li>What you need: The GeoJSON created with Overpass Turbo.</li> <li>What you get: GeoJSON with image preview links</li> </ul> <p>To make our map, we need not only links to the Flickr page for the uploaded images, but also a link to the preview image itself. The <a href="https://mikelmaron.github.io/geojson-flickr-groomer/" target="_blank">GeoJSON Flickr Groomer</a> is a simple tool to create those links.</p> <div class="wp-caption aligncenter" id="attachment_653" style="width: 727px"><a href="https://geojournalism.org/wp-content/uploads/2013/08/9628249541_81308bae87_b.jpg"><img alt="Credit: Mikel Maron" aria-describedby="caption-attachment-653" class="wp-image-653" decoding="async" height="538" loading="lazy" sizes="auto, (max-width: 717px) 100vw, 717px" src="https://geojournalism.org/wp-content/uploads/2013/08/9628249541_81308bae87_b.jpg" srcset="https://geojournalism.org/wp-content/uploads/2013/08/9628249541_81308bae87_b.jpg 1024w, https://geojournalism.org/wp-content/uploads/2013/08/9628249541_81308bae87_b-300x225.jpg 300w" width="717"/></a><p class="wp-caption-text" id="caption-attachment-653">Credit: Mikel Maron</p></div> <p>Open the GeoJSON file downloaded from Overpass Turbo in your text editor. Copy all the content, and paste into the first text box. <strong>Click here to Run</strong>, then <strong>Download groomed-geojson.json</strong>. Note the location of the GeoJSON file, we need it for the final step.</p> <h2 class="summary-item" id="make-a-map-with-tilemill"><a href="#make-a-map-with-tilemill">Make a Map With TileMill</a></h2> <ul> <li>What you need: The GeoJSON modified by GeoJSON Flickr Groomer.</li> <li>What you get: An interactive map (finally!)</li> <li>Learn more: <a href="https://www.mapbox.com/tilemill/docs/crashcourse/introduction/" target="_blank">TileMill Crash Course</a> and <a href="https://www.mapbox.com/help/#help-mapbox" target="_blank">MapBox Help</a></li> </ul> <p>TileMill is a tool for designing maps. There’s a lot to it, so do check out the Crash Course, and other guides on the TileMill site. <a href="https://www.mapbox.com/tilemill/docs/install" target="_blank">Install TileMill</a>, start it up, and create a new project; uncheck <strong>Default</strong> data. Now, in the lower left, click the <strong>Layers</strong> buton, then <strong>Add Layer</strong>. For the <strong>Datasource</strong> field, browse and find the GeoJSON file downloaded from GeoJSON Flickr Groomer. Click <strong>Save &amp; Style</strong>, and you should see a map of your points on the left side of the screen. To zoom to the area of just your data, reopen the Layers dialog, and click the magnifying lens next to the layer.</p> <div class="wp-caption aligncenter" id="attachment_654" style="width: 727px"><a href="https://geojournalism.org/wp-content/uploads/2013/08/9511708544_e5c3d10335_b.jpg"><img alt="Credit: Mikel Maron" aria-describedby="caption-attachment-654" class="wp-image-654" decoding="async" height="394" loading="lazy" sizes="auto, (max-width: 717px) 100vw, 717px" src="https://geojournalism.org/wp-content/uploads/2013/08/9511708544_e5c3d10335_b.jpg" srcset="https://geojournalism.org/wp-content/uploads/2013/08/9511708544_e5c3d10335_b.jpg 1024w, https://geojournalism.org/wp-content/uploads/2013/08/9511708544_e5c3d10335_b-300x164.jpg 300w" width="717"/></a><p class="wp-caption-text" id="caption-attachment-654">Credit: Mikel Maron</p></div> <p>On the right, is CartoCSS, used to style your map. We want to make some small changes, making the background of the map transparent (by default it’s sea blue). Here’s what our CartoCSS looks like:</p> <pre>Map { background-color: transparent; } #images { marker-width:6; marker-fill:#f45; marker-line-color:#813; marker-allow-overlap:true; }</pre> <p>Now, add <strong>Interactivity</strong>, the dialog is reached by clicking the small hand in the lower left tool set. Click <strong>Full</strong>. Here you can specify what appears when you click on a point. All of the tags for these features from OSM are available, you’ll see them in a list at the bottom of the dialog in “Mustache” tags. We set the content to this below, to show the name of the feature, and a linked photo.</p> <pre>{{{name}}} <a href="%7B%7B%7Bimage%7D%7D%7D"><img alt="" decoding="async" src="href%7D%7D%7D"/></a></pre> <p>The map is ready to share! Sign up for a <a href="https://tiles.mapbox.com/signup" target="_blank">free account on MapBox</a>. Then back in TileMill, click the <strong>Export-&gt;Upload</strong> option in the upper right, configure the settings for the upload (try to minimize the upload size), and <strong>Upload</strong>. You can watch the progress of the export and upload, and then get a link to the map.</p> <p><a href="https://a.tiles.mapbox.com/v3/groundtruth.map-vx5bbbu4/page.html" target="_blank">Here’s ours</a>!</p> <h2 class="summary-item" id="results-and-your-challenge"><a href="#results-and-your-challenge">Results and your challenge</a></h2> <div class="wp-caption aligncenter" id="attachment_655" style="width: 727px"><a href="https://geojournalism.org/wp-content/uploads/2013/08/9511711840_3d97a64423_b.jpg"><img alt="Credit: Mikel Maron" aria-describedby="caption-attachment-655" class="wp-image-655" decoding="async" height="365" loading="lazy" sizes="auto, (max-width: 717px) 100vw, 717px" src="https://geojournalism.org/wp-content/uploads/2013/08/9511711840_3d97a64423_b.jpg" srcset="https://geojournalism.org/wp-content/uploads/2013/08/9511711840_3d97a64423_b.jpg 1024w, https://geojournalism.org/wp-content/uploads/2013/08/9511711840_3d97a64423_b-300x152.jpg 300w" width="717"/></a><p class="wp-caption-text" id="caption-attachment-655">Credit: Mikel Maron</p></div> <p>So this is it! To get the streets background, you’ll need to dive a little more into MapBox hosting configuration. <strong>Try it out on your own, with say, 10 images.</strong> If you have any questions about this guide, suggestions to improve it, or just want to share your results, get in touch. Thanks!</p> <div class="author-shortcodes"> <div class="author-inner"> <div class="author-image"> <img alt="" src="https://geojournalism.org/wp-content/uploads/2013/09/mikel.jpg"/> <div class="author-overlay"></div> </div> <!-- .author-image --> <div class="author-info"> <strong>Mikel Maron</strong> (<a href="https://twitter.com/mikel">@mikel</a>) is a programmer and geographer working for impactful community and humanitarian uses of open source and open data. He is co-founder of <a href="https://groundtruth.in/">Ground Truth Initiative</a>, and of the <a href="https://mapkibera.org/">Map Kibera</a> project. He’s also Founder and President of the <a href="https://hot.openstreetmap.org/">Humanitarian OpenStreetMap Team</a>, having helped to facilitate the OSM response to the Haiti earthquake. He’s travelled widely, organizing projects in India, Palestine, Egypt, Swaziland, and elsewhere. Previously to this, he co-founded Mapufacture and worked on collaborative platforms, geoweb standards, and various applications, with a wide spectrum of organizations from UN and government agencies to anarchist hacker collectives. </div> <!-- .author-info --> </div> <!-- .author-inner --> </div> .author-shortcodes <meta content="text/html; charset=utf-8" http-equiv="Content-Type"/> <p>The post <a href="https://geojournalism.org/2013/08/how-to-map-photos-using-openstreetmap-and-tilemill/">How to Map Photos Using OpenStreetMap and TileMill</a> appeared first on <a href="https://geojournalism.org">geojournalism.org</a>.</p> 268