Getting Started - BlurbBits Utilities Overview

Getting Started - BlurbBits Utilities Overview


We've been adding a lot of new functionality and documentation so it's time to try to answer the question: What is the best way to get started with BlurbBits?

First make sure you've read our introduction or the BlurbBits Basics to get a high level understanding of our basic capabilities and concepts. It also helps to understand how to create a BlurbBit (url parameters, our interactive examples and publishing options). Remember our goal is to reuse as much information as possible, so check out our data extraction parameters before you start. We even document a complete geoblogging process but it helps if you understand the high level summary first..

BlurbBits - summary

BlurbBits are performance optimized map and photo sharing solutions for your blog or website. Standalone BlurbBits define a map and/or set of photos for a specific location or topic (the bits). Instead of adding photos one by one (a major hassle) and/or linking to a separate map or photo album, BlurbBits can be used to quickly add all the photos/map into a blog or website. Photos and maps are viewed directly within the BlurbBit on your page without forcing users to other sites or pages. Extract BlurbBits summarize data from various sources into overview maps and/or albums depending on the parameters.
  • Quick customized maps (standalone)
    You can adjust markers, zoom levels, location, travel path, map type and initial view. These parameters are also used to customize extracted maps. Location maps (&llz) also define a blog post's location when added to an individual blog post.
  • Online photos (picasa or flickr)
    Manages multiple photos from Albums or sets, with or without geotagged data from a user, group or other public data (does NOT define a blog post location). Changes made to the online photos will be seen when the BlurbBit is reloaded, automatically keeping your blog photos up to date.
  • Combined Maps and Photos
    The parameters from the sections above can be combined into a single BlurbBit which shows photos and defines a blog post's location. This can be used to manage all the photos and map for your blog post in a single utility (ie. widget/gadget) while allowing us to map your blog posts.
  • Summarize Data
    Create summary maps/photos from existing data using extraction options. Note: extracted data cannot be used to define a blog post's location, it must be defined using the LLZ map parameter (or via the mapr).
  • Publishing Options
    BlurbBits can be added to your blog (post or sidebar), website or emailed and linked using our publishing options. Use the Embedded Options (and Blogger BlogThis) to add a BlurbBit into a blog or website. Links can also be used in sites/blogs that don't support javascript. Our Gadget overload post might help you understand our thoughts on post vs sidebar publishing.

Utilities & Tools


BlurbBit Interactive Examples (in this Blog)

The interactive examples of the various sections can be used to learn about a specific set of BlurbBit features. Click on the icon to see the BlurbBit. Text entered in the textbox will be passed as the BlubBits URL parameters. Most parameters can be combined with other section parameters.

Design Mode (within a BlurbBit)


A BlurbBit in design mode displays the publishing options for the i (info) menu button instead of the standard info/sharing options. The interactive examples and the BlurbBits Mapr automatically enable design mode. Url parameters can be manually appended to the BlurbBit Url and published using this mode.

Dynamic GeoBlog Maps

Blog Before Dynamic Maps

Blog After - with Popup Map Displayed

Dynamic Geoblog Maps are created on the fly based on a specific pages content. A popup map (within the page) is created for each geo-located post along with a dynamic GeoBlog summary map for the pages content. Update: we've added some new functionality which will enhance your blog's performance even further.

BlurbBits Mapr


The BlurbBits Mapr has two purposes; to create & position multiple standalone BlurbBits and extract & position existing data via RSS feeds or the scratchpad. Existing online content can be extracted using Url parameters and the interactive examples can be easily added to a location to map it (using the extras dialog box). Scratchpad data can be published to the web via Google Spreadsheets and extracted into BlurbBits (a quick summary) and the BlurbsViewr (interactive navigation map).

BlurbsViewr


The BlurbsViewr uses the Url parameters (photos and extracted) to display objects on an interactive map. The map stays persistant while pages are opened below, making it a perfect tool to navigate your geo-referenced data. Use the Scratchpad/Google Spreadsheet to define your own data or combine multiple sources.

GeoBlogging Process

All of the above functionality can be used as a complete geoblogging process that supports remote posting, post centered photos/maps, and interactive Blog map, Dynamics maps and mapping of historical data combined with other websites (for a Travel blog, geotagged photo blog, any geospacial data-- geoblog). With Blogger you have a lot of mapping options that are great for combining with existing sites. Best of all it's free.. try it today!!

Start by playing with the interactive examples to see what standalone BlurbBits you can add (they are the fastest way to improve your site and see what data you already have). Get a basic understanding of the Mapr and the geoblogging process before you go too crazy.

What data do you have?

Photos in Flickr or Picasa work best with albums/sets and can be filtered further using tags to match content or location. Captions will automatically be added if available and remember you don't have to add/edit EVERY photo, they can become just like gadget overload if you are not careful. The mapr is the easiest way to combine photos with a map (to define a post location). If you use Picasa Web Albums, map them in Picasa first and use the Mapr to build a BlurbBit map Album.

If you just want to build an interactive map of your website/blog use the Mapr ScratchPad, at some point you'll need to define each location. If you have existing data you can reuse it by supplying the correct extraction parameters to the Mapr. The scratchpad is just that, so make sure you save the data so you can reuse it later. Try mapping a couple of locations and working through the process before you do them all.

Create a Travel Log

You can easily map your travels by building an electronic travel log in a Notepad text file (like this). Use the BlurbBits Mapr to Load the Scratchpad data (cut & paste your text), If you don't know your location, leave it blank, you can find it using the Mapr Find a Location features. Adjust the positions and set your zoom levels to highlight the correct area (zoom=8 middle of the ocean zoom=12 or 15 for anchorages with good maps). You'll need to upload the file into a Google Spreadsheet in order to map it in the BlurbsViewr.

Later, if you want, you can add photos and links to other pages, like your online photos, your website, wikipedia, or combine it with your Blogs (like this). Creating a BlurbBits enabled blog is the most automatic way of tracking your travels but using the travel log is a great start and it sure beats entering position after position into dialog boxes.

Blogger GeoBlogging Process

Blogger GeoBlogging Process


Blogs, photos and maps are a great way to share your experiences and map your geoblogs to track your travels. With Blogger and BlurbBits you have access to one of the most flexible and powerful geo-blogging environments available. You can easily add photos and/or maps while sitting at home, an internet cafe, the middle of the ocean (via Email) or directly from your Mobile phone.

The flexibility of BlurbBits combined with Blogger's various posting options and the information that is available through existing blogs and photos sometimes makes it difficult to understand exactly how use BlurbBits with your blog.

The obvious thing that is missing is the location for each blog post. The easiest way to add it is within the blog post text (36 17.63 N 30 08.98 E or llz=36.2938,30.1497,14 see Blogger extract) which gives us some viewing options for the resulting data.
If you do nothing else, we highly recommend that you add one of the above location types into your blog text (you'll thank us later).



Note: The Dynamic GeoBlog maps are necessary to view these maps within your blog post. Nothing is added directly to your blog post and readers following your blog (RSS Feeds) will only see the lat/lng string. BlurbBits can be used to visualize these location maps within your blog post and easily add/manage online photos for all your readers and followers. Update: we've enhanced the functionality and can convert BlurbBit links into dynamic popups (maps and photos). Add the gadget via the link above and start adding the lat/lng text format to the posts you want mapped, it's the easiest way to get started. We've also added support for post summaries which can be used to optimize your blogs performance and improves traceability.


Stand Alone BlurbBit Examples

It is important to understand that there are two parts; the standalone BlurbBit which allows a map or online photos (and both) to be added to a specific blog post/entry (or sidebar) and the extracted data which can then displayed in various utilities. Note: The goal of this post is to define a process and NOT the details/options of each utility which is used, detailed documentation is available though the additional links provided.


Extracted BlurbBit Examples

We will document a complete process that supports an interactive blog navigation map AND uses BlurbBits for photos and maps within the blog. We also provide options for mapping existing posts. Note: This process can be used for any geo-referenced data (news, travel blogs, photo blogs) where maps and/or photos help clarify a specific post topic or location.

Define a Post/Entry Location

First lets start by adding a location to an existing Blog post. A Blog location can be defined by a BlurbBits Map or by lat/lng text for Blogger's mobile options.

Basics: BlurbBits are created/customized via Url Parameters.

Map BlurbBit:
&llz=36.2938,30.1497,14&mi=in
A map BlurbBit with initial view zoomed in.
Adjust the lat,lng,zoom parameter above if you feel comfortable
(Map options)

Click theicon above to see the resulting BlurbBit. Click i (info) in the top BlurbBit menu to see the publishing options (see example results/options in a single blog post). You can also try adding the lat/lng string (make sure it is a different location so you'll it).

Add the BlurbBit to a Blog Post

Open a new Browser window, login to Blogger and create/edit a new post. Make sure the post editor is in Edit Html mode.

Go back to the BlurbBit info window and double click in the textbox under Embed in Website/Blog Entry (with feed) to highlight all the HTML code. Use a right mouse click (RMC)-Copy to copy the code, then switch to the Blogger editor window and RMC-Paste to paste it. Update: If you are using Dynamic GeoBlogs you can use the Add Text Link in Website/Blog option and we'll take care of the rest for you.


Notice that all the HTML code is contained within <!--BEGIN-BLURBBIT and END-BLURBBIT-->. Blog post text can be added before or after these BEGIN/END statements. If you want to change/delete the BlurbBit select all this HTML code and paste over it with the new HTML code or simply delete it.

Now publish your post and view your blog. The map you created should appear within your new post, if you have issues make sure you added the code in the Edit Html mode editor.

Extract a Map of Blog Entries:

That puts an quick map in your post but it also defines its location for other utilities. Before we go to far lets make sure we can extract the post location data. First find your BlogName or BlogId if you ftp publish your blog (parameters &blogger=BlogName:Number:Options)
  • BlogName is configurable portion of your Blogspot address
    ex: use blurbbits for http://blurbbits.blogspot.com
  • BlogId is used to access the data for ftp published blogs
    Create a new Post or Edit an existing post
    you should see post-create.g?blogID=XXX or post-edit.g?blogID=xxx
    ex: use the blogID value (XXX)

    Note: by default we only extract the last 10 entries, use the :Number parameter to extract more.
Blog Map:
&blogger=svbillabong&width=220&height=200
A Blogger map for svbillabong.blogspot.com
&bloggerid=13526182&width=220&height=200
The same map accessed via BlogId

Adjust the example above to your BlogName (or BlogId) and click theicon to see the resulting BlurbBit map which is extracted from your blog. If a map does not appear check the Blogger extraction options and make sure your RSS feed and Blogger parameters are setup correctly.

A single blog post on a map is a little boring so lets find some more locations to add to another posts. Note: At this point you've done the basics, which allows you to map your blog posts and re-extract them into the other utilties (the blogger=xxx parameters can also be added to the BlurbsViewr and BlurbBits Mapr). The following are options which help you find your location, easily add photos and explain other utilties and viewing ideas. We'll also give you some options for your historical blogs and new post published via Mobile Options.

Finding a Location

Open the BlurbBits Mapr (new window). The map should center near your current location (it may use your internet service providers location or start at 0,0).

Basics: The BlurbBits setup map is designed around a right mouse click (RMC) context menu.

You can either:
  • Drag the map around to find an exact location
  • Enter your location in the Find a Location text box and click Go.
  • Enter your Lat/Lng in the Center Lat,Lng,Z: text box and click Move.
Adjust the zoom level with the slider on the left hand side of the map. The Center Lat,Lng,Z: textbox value is the &llz parameter we use to map a location.


For now highlight the Center value and use the RMC-Copy to copy it. Select 36.2938,30.1497,14 (or your value) in the Map BlurbBit example above and use RMC-Paste to replace the value.
Click theicon to see the new map. Repeat the Add to an existing post steps above with another blog post.

Reload the Map of Blog Entries and notice the new location on the Blog map. All utilities which use extracted data will be automatically updated with the latest available data when they are used or reloaded.

There are various ways to find the lat/lng of a location/address, but only you know the details and zoom level you want to highlight with your map. The easiest way to find a location and adjust/prototype a BlurbBits location is through the BlurbBits Mapr. You can even save all the results to the scratchpad so you can easily modify or combine the data later.

Adding Online Photos


After Selection
Blogs and maps are great but a picture is worth a 1000 words. Adding photos can be a real pain especially if you add more than one or you try to add them into previous posts (like those published remotely).


w/Photos Before
BlurbBits are designed to quickly add multiple photos to a blog post from online photo sharing sites and has advantages over traditional methods (including embedded slideshows). Online photos can be selected by a user, albums/sets, and/or a filtered by tags to match your blog post/entry content.


&picasa=SailBillabong:Sailing2007
A Picasa Album
&flickr=25998359@N07:set=72157607010384141
A Flickr Set (use &flickrgeo for geotagged photos)

If you want to add your own photos, read the documentation for picasa or flickr photos and choose your filtering parameters (or use ours for now). Enter them in textbox above.

Click theicon to view your BlurbBit with the extracted photos. If the photos contain geotags, a Geo-Photos summary map will also appear. This map is dynamically extracted from data on the photo sharing site and therefore cannot be used to define the Blog post location within Blogger (without making the process unusably slow). Note: you can use the mapr to extract the position of your geotagged photos to use as LLZ parameter for a post. Mapped Picasa Albums build complete map/photo BlurbBits.

Add a Post Location Map to the Photos

Define the post location by appending &llz=36.2939,30.1496,14&mi=in (or another location) to the photo parameter textbox above. Click the icon to view the BlurbBit and notice the map which now appears along with the photo viewing options. When a BlurbBit is embedded on another website, we show a single highlight photo and wait to load the photos and map until the user selects a viewing option.

Select the Photo Strip menu button and then select a highlight photo (using the thumbnails) which best summarizes the collection of photos or the blog post topic you'll be writing about or adding the photos to.

Click i (info) in the top BlurbBit menu and add the BlurbBit to a post (refer to the section above if needed).

Note: The location definition MUST be added to photos in order to map the blog post in extracted utilities. The easiest way to accomplish both is to use the BlurbBits Mapr (with markers) to define the location and copy/paste the photo parameters into the extras textbox. If you use Picasa albums you can easily generate Mapped Picasa Albums.

BlurbBit Add Gadget



If the location you added is new, you'll also see it on the Extract a Map of Blog Posts BlurbBit above. You can use the Blogger Add Gadget publishing option to add this map to your sidebar. Make sure you read Gadget Overload post to understand the tradeoffs/options.

BlurbBit BlogThis

Now if you are deathly afraid of the HTML post editor or just want a quick way to create a new post for your BlurbBit, click the Blogger BlogThis button under the publishing options.



A Blog Your Bit popup will appear. If you are NOT already logged into Blogger, click the Login to access your Blogger account (you only need to do this once). Choose your Blog (if you have more than one) and then change the title, write the post text and add labels etc by following the notes above each section. The BlurbBit will replace the [BLURBBIT] tag, so feel free to add text before and/or after. Click Publish Post, the un-formatted blog will appear below as a preview. Select the link to navigate to the actual blog post (or view Our Sample result .. cheater).

If you only create new posts and are always connected to the internet when you blog, the BlogThis option is simplest solution for creating new blog posts with any BlurbBit (including photos, maps etc). We didn't start by showing you this option because we want you to be able to add BlurbBits to your posts using the post editor for existing posts and those posted remotely via email.

Remote Blogging

Did you know you can post blogs via email (moblogging)? It's great for keeping people updated, even from the middle of the ocean, and you don't get more remote than that!!

Most remote emailing systems (uuplus, winlink, skyfile) only support plain text emails, so HTML formatting is not supported. After you set up your Blogger account for posting via email, you should test that it is working by sending a simple test text (and optional attached photo) to your Mail-To-Blogger address (add 42 15.0N 70 52.9W to the email text to map it). Some remote email systems add end of line characters to outgoing mail so make sure you test it from your actual remote system before heading out (or your formatting will be terrible). You can also remove the additional text which gets appended to the end by some email systems, put #end at the end of your post. With skyfile, adjusting the email editting window size changes the location of the end of line characters.

Overview

So now you know how to define a posts location, add photos, a map or both to an existing or new Blog post, extract a Blog map (into a BlurbBit), find a location to map, blog remotely AND add BlurbBits to the sidebar. We have two mapping options that highlight blog post location data which could effect how you choose to map your existing blog posts.

BlurbsViewr Interactive Maps



If you only want to create an interactive Blog map, append the Map of Blog Posts Blogger specific parameters to the BlurbsViewr (new window) (ie. ?blogger=svbillabong). You can change the number of posts shown and even filter post for a specific trip or area by adjusting the Blogger extraction parameters. A map icon will appear for each blog post with a defined location.

This is a great way to navigate your blog but some people don't like to use interactive maps (can you believe that?). Plus people who follow your blog through a RSS feed can't choose the sidebar Show Interactive Blog Map because the sidebar doesn't exist in the feed view.

Dynamic GeoBlog Maps



Dynamic GeoBlog maps are the most flexible way to show your post locations within Blogger. These maps are created on the fly based on the content of each page: A popup map is added to each post which contains a location, (including those posted via remote blogging emails) and a summary GeoBlogs on this Page map if GeoBlogs are found. These dynamic maps only work within Blogger, not the Blogger feeds.

Mapping Existing Blog Posts



The easiest way to map a Blog post is to extract the Blogger data into the BlurbBits Mapr by appending the Map of Blog Posts Blogger specific parameters to the Url BlurbBits Mapr (new window). If a post location is defined, a icon will appear next to the blog post title. Clicking on the list (or map marker) will center the map at the stored lat/lng location AND zoom of the post (if available). Posts with the icon have no defined location.

Use the mouse to highlight (don't click yet) an undefined blog post entry. If needed, use the preview window (to the right) to refresh your memory of the posts content.

Use the Finding a Location methods above and choose a zoom level you want to map. Make sure the LLZ (Lat,Long,Zoom) Locator is centered by clicking Move next to the Center Lat,Lng,Z: text box.

Now select the post in the sidebar list and then click on the LLZ icon to set the posts location/zoom. While you are dragging the unplaced post marker, you can place it anywhere by clicking on the map (the BlurbBit will always center at the post location/zoom).

Once you have defined a blog post, you can preview it's BlurbBit Map by clicking the Preview BlurbBit button (for blog posts we suggest you disable the Use Label: toggle). You can add photos or customize the map (markers, paths etc) by adding parameters to the Extras textbox. Note: The first preview of a Object defines (and stores) the BlurbBit definition (within the Mapr), so make sure you set the Update toggle to make subsequent changes and unset it again before changing to a new post!!

NOTE: The BlurbBits Mapr does not modify your existing blog data so you need to add a BlurbBit to each blog post. The easiest way to edit a specific post is to click on the link in the preview and then click the Edit Post icon at the bottom.

If you plan on using Dynamic GeoBlog Maps and you don't like using a full map for each post, you can use the BlurbBit Add text link in Website/Blog publishing option (for maps only) and you'll get a popup map.

Now What?

Decision time: What do you want to do about all your old blog posts?

Obviously you could continue to map posts, generate BlurbBits and add them to each post you want to map (you don't HAVE to map them all). In fact, that's the only way you'll get a map within a Blogger post and provide support for feeds. If you have a small number of existing posts this might be the easiest cleanest way. Everyone will have access to a post map (including new or catchup readers)!! While you are adding the BlurbBits to define the location, you can also add new photos you feel would enhance your existing posts. Mapped Picasa Albums can also be created quickly with the Mapr.

Just the interactive map please

If you have 100's of posts but no one is reading the older ones and you aren't changing/editing them any more, we have a solution. We'll use the Mapr ScratchPad to save your data and then load it into the web based Google Spreadsheets to re-extract it. We'll also combine the older data with the latest additions from your Blogger feed. Note: Saving the data takes a snapshot of the blog posts in its current state, so subsequent changes to those posts will NOT be seen.

You don't need to map every post just to see a trail of where you've been. You can also draw lines in the BlurbBits mapr and combine it with blog posts using Google Spreadsheets command options or scratchpad data (try drawing a quick line)!! You can also combine your blog with another website using the Scratchpad/spreadsheet method.

Saving the Scratchpad

Switch to your blogs Mapr window (from above) and select Text Tab Delimited in the ScratchPad Format pulldown. Then click the Save To Scratchpad button. Use the RMC-Select All in the scratchpad window to select and then RMC-Copy to copy all the text. Open a new text document with Notepad (or a simple text editor) and paste the text. Save the document.

Using Published Google SpreadSheet (GSS)

Now you have a snapshot of your newly mapped posts, but we know you don't want to have to edit this file every time you add a new blog post. We'll use Extract Commands and our Blogger parameters to combine the two.

Follow these instructions to import your saved scratchpad file and publish it. Here's the example file.

Combine with latest Blogger data

The second row contains the extbb+ and our Blogger parameters (&blogger=BlogName:Number:Options) blogger=svbillabong:50:published-min=2008-10-30T10:18:00Z. The :50 specifies Number, a maximum of 50 posts. The :published.. field sets the minimum date Option so only posts dated after the specific date/time will be included. In order to succeed, the published-min must be set to return at least one post entry, otherwise a Nothing Found error will be returned.

Select the first row by clicking the 1 in the furthest left hand column. Use the RMC-Insert 1 Below button to add a new row. Add extbb+ to the first column and the correct Blogger extraction parameters, maximum post and published-min parameters to the second column (as above). If you publish frequently use 100 instead of 50. Make sure the date/time is between the first two posts (I add an hour to the second posts time).

Select the third row and use RMC-Delete Row to delete the first blog posts data. You may want to add a new test post to make sure it gets added correctly. Note: The bottom of this file also contains Lines for each years sailing track (L) and all our Picasa Albums (A) for our starting location.

The Full Monty

What's the best way to manage a travel blogs new posts? Our process varies slightly depending on how/where we publish our posts.

Via Email: We add our lat/lng location to the top of the Mail-to-Blogger email and sometimes attach a small photo (250 px max). We organize and edit our photos in Picasa (remotely) and then upload them when we get internet access. Then we use the Mapr to extract our recent Blog posts (and their text lat/lng data) to create a BlurbBit with a map (the minimum) or a map and photos that we've filtered to match the post (we also check and tweak the map zoom level). We add these new BlurbBits back into each post we published remotely (since the last time we had internet). Sometimes we create a new trip summary post and add an entire album to it (with our current location), you could even add your travel path (we update our KML file from our GPS)!!

Connected to Internet: We use the Mapr (with no Url parameters) to find our location. If we have more than a couple of photos, we combine them with the location Map and add our BlurbBit to the post or use BlogThis for a new one. For posts with single photos we use the standard post editors add image button. If we know our location, I just tweak the BlurbBit Url parameters using the interactive examples as a guide (yes I still need a manual).

Note: since we use the Dynamic GeoBlog maps we use the Add text link in Website/Blog Publishing Option to add a map only BlurbBit (you'll get a popup). However, since we've started using BlurbBits we always add photos to our map (it's almost too easy).

Migrating Existing Gadgets

You don't need to adjust your existing post photos (unless you want to). Check out our post on Gadget Overload for some hints, along with ways you can keep people up to date with your changes as you integrate BlurbBits into your blog.

Combining with other sites

We started out our travels with only a website. Then we started blogging so we could email from remote locations, but still kept our website going. Now we do much more in Blogger because it's so easy. We still update our site and manually map new page links (via the mapr scratchpad). The minimum data required is the TYPE,LLZ,LABEL,URL. DATE is necessary if you'll be sorting the results and DESC provides the preview text. Check out the scratchpad and the column details for more information. Make sure the columns match your Blogger ScratchPad data and copy/paste the new rows and add them to the top of your published Google Spreadsheet. Here's our combined file.

If you are using Blogger to track your travels (and why wouldn't you?), don't forget to add a "where" or tracking (or both) BlurbBit to your non-blog site. Use Map of Blog Posts parameters and/or add extracted map views (&mv=where&mi=in) to create a BlurbBit which shows your latest location and blog post (example).

Adjusting/Copying an Existing Blogger BlurbBit

Note: we highly recommend using the scratchpad to save complicated BlurbBits data.

Blogger currently changes the HTML code it publishes (ie. & becomes & amp;) which makes it hard to get back to the original BlurbBit URL. If the BlurbBit is simple just replace it with a new one, but if it is complex or you simply want to add or adjust parameters (and don't feel comfortable editing the raw HTML), use this Design Mode technique.

Edit the post/gadget HTML code and find the first blurbbits.html? within the begin-end of the BlurbBit. Add design=true& after the ?, this enables design mode. Publish the post (or save the gadget) and click the info button. Use the Paste link for email or IM path to get the original URL, adjust as needed.

Note: This Design mode adjustment can also be used if you want to allow users to be able to add your BlurbBit to their site.

If you use the Mapr, you can also save BlurbBit source data to the scratch pad which makes it easy to adjust travel paths etc later. You could also copy the iframe src= string (for embeded) or anchor href= string (for links) to a text editor, replace & amp; with &.
Interactive BlurbsViewr Maps

Interactive BlurbsViewr Maps


Add a map to navigate your website or blog posts

Interactive maps have been around for ages but most people embed them directly into their page. This means that every time a user changes pages the map needs to be reloaded and built again.. and again.. and again!! If your map has a lot of data this can be painful and time consuming and the view changes during each reload losing the continuity you were trying to gain by adding the map in the first place. Maps can be made quicker by only having one location but then what's the point, why not use Static maps or a BlurbBit (two zooms + title) instead?

Now I'm sure you've also seen maps that allow you to navigate to other pages. They either stuff all the information in a tiny info window or open in another window or tab. To get to the actual page, you usually have to wait while the map adjusts the info window.. one click on the map icon, wait... , find the link in the info window and click it, find the tab.. uggh. I know because I used the exact solution for our sites.



The BlurbsViewr opens your pages directly in a window below the map, allowing us to maintain the map while your site changes your pages. Users can navigate the context of the map and your pages quickly while maintaining continuity of the complete "picture". They can also find additional content nearby whether it's your own content, like photos or videos near the blog, or through optional layers like Wikipedia and Panoramio photos. Here's an example that ties ALL of our our sailing sites together: our SailBillabong.com Journals, Photos, You Tube videos and our svbillabong.blogspot.com blog. The map will open with a preview of our latest post and position automatically extracted from our blog.

Use the drop down menu list (top right corner) to navigate the content or just browse the map (instructions under ?). If you want just a page preview first, disable the Quick Link Option (under Map Type/Extras). If our photos don't do a good enough job describing the area or you want to learn more, enable the Wikipedia and/or Panoramio layers.

So there you have it, a full interactive map to navigate all your geotagged web pages and content. Please let us know what you think!!

Note: This map data was hand entered from our SailBillabong site while the latest blogs are automatically extracted from the Blogger feed data and it's BlurbBits. We can automatically map GeoRSS feeds, geotagged photos, and blogs posts/Web pages tagged with BlurbBits (that also support feeds).

If you use Blogger check out the GeoBlog mapping options and our Travel Blog process.

Geotagging data

If you have a feed (without geotags), try extracting the data with the BlurbBits Mapr and drag the entries into position on the map (don't forget about zoom). Save the data to the Mapr ScratchPad (text tab format) and upload it (or copy paste using Ctrl-C Ctrl-V) into a Google Spreadsheet. Share the spreadsheet and load it into the BlurbsViewr and you've got yourself a pretty cool map. That is the fastest way to get your non geotagged blogs/pages onto the map. Then you can use the data to add go back and add BlurbBits with photos and/or maps where desired (without them nothing extra will appear in your post or feed.. ie no links, photos etc). You can even combine the two, handling historical blogs with a spreadsheet while adding BlurbBits to your new posts.. the best of both worlds.

If your site doesn't support RSS feeds you can easily build a spreadsheet that contains all the data (I said easy NOT quick). The basics are the URL for each entry, a Label and a Description and Type (required). Photos are optional but enhance the preview and the chance that users might click through to the page (you can add these later). Check out the ScratchPad format and options and this sample ScratchPad data.

Url Parameters for BlurbsViewr

All of the data extraction parameters and are supported by the Viewr (&bp=1 is redundant). Online Photos parameters can also be used if they have geotagged data.

Other supported parameters

&mtitle=map title (see Basic Setup)
&mt=map type (see Customizing your map)
&mv=where will zoom map to latest entry at initialization (if location is defined)
&tt=travel Turn on the Trip Tracker
&mi=in|out Defines the initial map view (latest entry or all points)
&zoom=zoom Default zoom value for locations without a zoom
&llz= (initial location) good for highlighting an area of your trip but not a specific point (no marker is added).
&qlno=true disable quicklinks on initialization. Shows a preview first however it is important when custom maps are generated that do not contain URL links to pages (just popups).
Cool Things To Try

Cool Things To Try

Here's some cool things to try with BlurbBits

This assumes you have a little understanding of how BlurbBits and the BlurbBits Mapr work.

Fun with Photos

One of the main reasons we go though the effort of selecting, organizing (tagging and captioning) and cataloging our photos (into albums or sets) is for our own enjoyment. There is nothing like an album of your favorite photos to stir up some memories to reflect on past adventures.

If you don't have a blogger account sign up for one. It's easy and you'll be Blogging in two minutes.

BLURB-THIS - a BlurbBit & Blog for a Picasa Album:
&picalbums=SailBillabong
Photo albums from SailBillabong (try your Username)
  • UserName is your Picasa login name
    Login and check the path http://picasweb.google.com/UserName
    ex: use SailBillabong for ...com/SailBillabong
  • Learn More
Open the Albums by clicking the Icon and make sure some albums are found for your account. You are also welcome to use ours as an example.

Now run the BlurbBits Mapr with the album URL parameters from above (replace the & with ?). ex: ..setup.html?picalbums=SailBillabong

This will load the Picasa albums in the sidebar and place those with a defined location on the map (ah the glory of data re-use). Click on an album and if it is not already placed, drag it onto the map and click to set the location (and current zoom). If you are using this album to define a Blogs location adjust it as needed. This is where it helps to use the LLZ to pin point the location/zoom and then drag the album to it. Adjust the zoom level if needed; find the zoom level you like and use RMC set Zoom. Adjust the Map or Photo Parameters as necessary (don't forget toggle to update). Try adding these for a start &mark=midredx&smark=tinyred (append to the end of the extras line) . Preview your BlurbBit, open the photostrip and select the photo you feel best summarizes the photos or thoughts. Make any adjustments and re-Preview. Once satisfied, select the i (info) button and click the BlogThis button.

A Blog Your Bit popup will appear. Click the Login button and login into your Blogger account (you only need to do this once). Choose your Blog (if you have more than one) and then write your post; add more details about the trip, add any reflections you may have had or just describe the album. The BlurbBit will replace the [BLURBBIT] tag, so feel free to add text before and/or after. Select Publish Post. The unformatted blog will appear below as a preview, select the link to navigate to the actual blog post (or view Our Sample result .. cheater).

Now that wasn't that bad, you've got a blog post describing your trip or photos, an entire albums worth of photos, complete with captions, geo-photo map, notes and a link to the Picasa photos online. If you have your photos tagged (or in sets via Flickr) you can easily filter them to a specific topic or location that you want to write about. Filter your Photos and write your Blog or write your blog and then find the photos that match your topic.. it's that simple.

Then slice and dice the results into different views...

Interactive Examples:
&blogger=blogsmapr
A Blogger map for blogsmapr.blogspot.com
&blogger=blogsmapr&bp=1
A Blog Album (blogs with photos only)
&blogger=blogsmapr&mv=where&mi=in
A BlurbBits "Where" Blog map with link to latest post and last known location.

And ..
An interactive Blog navagation map with similar viewing options (last location or full view).

When you are finished with the Album don't forget to unset the update toggle or you will overwrite the other albums on subsequent previews. In most cases the update toggle is a good way to set the default preferences for many objects. Picasa albums are the only objects that come pre-configured (so far).

If you want to add a path or route to your album, use the RMC to set the map to add line mode and use left mouse clicks to draw your line (use RMC to stop adding points). Then select the entire path description to the right of the Preview BlurbBit Button and copy it (CTRL-C or RMC copy). Select the album and paste the new path at the end on the Extras line. Don't forget to replace the ? with a & (we'll remind you). Make sure the Select Toggle is enabled and Preview your new addition. Double check your photo maps if you changed the zoom of your album location. If the line doesn't appear make sure the Select toggle in On!! (My Sample Route result).

Now you added a travel map and favorite, last or average position to all the photos, not a bad way to enhance your blog. It doesn't stop there, if you have more than just a blog, you can map ALL your webpages. Here is all of our SailBillabong journals, photo albums (the old way), videos and our blogs (automatically updated).

If you are using a public machine don't forget to logout of your Blogger account.

An interactive Trip Photo Album map

The good thing about maps is they give users a really good sense of your travel destinations. The bad thing is you need to define where you were in order to build them. If you already have geotagged photos they'll automatically appear on the Viewr map. If not ..the thought of geotagging 25,000 photos is mind boggling. The good news is you don't really need to geotag every photo to map them, just the albums or your own web pages that display the photos.

Picasa albums are really easy because you only need to set one location per album and we automatically convert the album into a BlurbBit with all the photos.

Run the BlurbsViewr with your Picasa Album
ex: .../blurbsviewr.html?picalbums=SailBillabong

Your albums will appear with the latest album highlighted. When you open the album (select from the list, click [more] or double click on the icon) the BlurbBit for album photos will open in the window below. Quick and easy way to navigate all you trip photos eh?

There's more.. if your albums represent a single trip (like ours) you can create a rough Travel Track with the date and location of the albums. Add &tt=travel&mi=out to the BlurbsViewr album parameters (or Try Ours).
ex: .../blurbsviewr.html?picalbums=SailBillabong&tt=travel&mi=out
You'll find out VERY quickly how accurate your dates and locations are. Highlighting the Trip Summary will display the approx distance Traveled.

If that's too much work to clean up, you can draw the lines in the BlurbBits mapr and save them to a Google Spreadsheet. See our Example with Drawn Tracks. These paths can also be used when creating a standalone BlurbBit of just the album to embed on your page.

The ultimate trip photos map.. all of our individual geotagged photos and our drawn lines or you can overlay them with our actual GPS tracks (from KML).

Remember if you don't use Picasa albums you can still use the ScratchPad to enter your data for each page and then use a GoogleSpread sheet to extract the data for the Viewr. You can even combine your photos and your blogs on the same map or heck do everything. Don't forget the best part, any changes or additions you make (to extracted data) will be updated on the map. As we add BlurbBits to our new Blog Posts they will automatically appear on the map, we don't have to do anything!! Yes!!

GeoTag and Educate with Wikipedia

We like to share more than just our photos,blogs and journals. If you've read our Blog you know we frequently refer to Wikipedia articles so that reader can learn more if they are interested. A nice quick introduction through our travels with some notes, to a full on encyclopedia at the ready.. the reader can choose!!

Wikipedia is a great free online encyclopedia FULL of information AND geotag data. Most geocoding services are focused around address etc but Wikipedia covers almost everything. I've found Suwarrow in the Cook Islands (no full time inhabitants) and Niuatoputapu in Tonga both rather remote by modern standards of travel. They even had Onotoa the first place we went that wasn't in our Lonely Planet.

Go to the Main Page and enter a search string in the left hand side. Find the article you are looking for and note the top right hand corner. If there is a globe with a link click the link to open the Geo Hack Page. Look for Coordinates (second line) and enter the decimal value into the BlurbBits Mapr Center Lat,Lng,Z: text box, and select Move. You can also enter the decimal value directly as an &llz= parameter (add a ,zoom value if desired).

This is a great place to search for more information and who knows, you might even learn something while you're there. Save the path so you can add a link to your blog/website. If you find an article that doesn't have a reference but you find one, consider adding it to Wikipedia.

The Ultimate Off Line GeoTagging Combo

We use Google Earth at Sea on Billabong (without Internet!!) to help in areas where charting is poor. It is amazing how good the imagery is, you can clearly see most reefs and in some cases you can even find the sandy patches where you want to set your hook. First you must visit the areas you are interested in while connected to the internet. Keep an eye on the Streaming indicator which appears just below and a little to the right of the Earth. When this indicator has reached 100% the imagery you're viewing is fully loaded and saved to your cache. Increase the cache size to get the most out of your data and you can even use the Touring Places feature to automatically store data based on a set of placemarks (ie. Markers) you setup.

As if that isn't cool enough, Picasa has a geotagging feature that works directly with Google Earth. You can even use your saved GPS tracks to import into Google earth to help find the date/time and position for your photos. There is even a program that does it automatically. The problem is most people either don't have a GPS or haven't saved their tracks, so the manual placement mode via Picasa/Google Earth is necessary. The good news is once you've done it, the data lives within the photo as metadata so tools like Picasa and BlurbBits have access to it.

If you have GPS tracks saved and want to get them into Google Earth check out GE GPS import (for the non free versions) or look into the ultimate GPS Utility (in and out of MaxSea, Google Earth etc) or a online translation program called GPS Visualizer. In most cases GPS data stretches the limits of the Static Map APIs 50 Point, however we are working on some potential solutions (Douglas-Peucker algorithm) but will certainly support it in our interactive maps (we've got 28,500 nM of GPS tracks.. We'll make something work).
Extracting Data

Extracting Data


Most data extraction Url parameters will work for BlurbBits (to embed on your page) , the BlurbBits Mapr (to help build your BlurbBits/Maps), or the BlurbsViewr (to navigate your site). Online photo parameters can also be used.

Blogs

This is where your work pays off.. we can put your Blog entries on a map or create a Photo Blog Album. We will extract a lat/lng position from the entry text or the first BlurbBit (with an llz position) and the first photo for each Blog entry . The text option is necessary when using Blogger mobile via email, which doesn't support html without rich text emails (not available through most remote email services).

The lat/lng text format is DD MM.MM[N|S] DDD MM.MM[E|W] (with no extra characters i.e. 36 17.63 N 30 08.98 E). The separator between lat/lng can be a space, comma or /. The llz= parameter can also be added as a string (llz=[-]DD.DDD,[-]DDD.DDD,Zoom i.e. llz=36.2938,30.1497,14) where - is used for South and West and zoom is optional but should be used if changing between remote locations (middle of ocean, zoom = 8) and street/anchorage maps (zoom=15).

Note: The text MUST be on the same line with no Extra characters.


In order to extract both photos and positions from Blogger the Full Post Feed MUST be enabled. Go to Settings-Site Feed and make sure Allow Blog Feeds is set to Full (or Blog Post Feed in Advanced Mode).

Note: We will combine duplicate locations and if more than 50 unique entries are found, they will be averaged over the whole set. Text Blog entries should be updated when internet is available by adding either a BlurbBit link or an embedded version. You can define the maps zoom level and it allows other tools, utilities and your RSS feed readers to enjoy your location.

A Map of Blog Entries:
&blogger=BlogName:Number:Options or bloggerid=BlogId:Number:Options
  • BlogName is configurable portion of your Blogspot addess
    ex: use blurbbits for http://blurbbits.blogspot.com
  • BlogId is used to access the data for ftp published blogs
    Create a new Post or Edit an existing post
    you should see post-create.g?blogID=XXX or post-edit.g?blogID=xxx
    ex: use the blogID value (XXX)
  • Number is the number of entries to extract. Default is 10
    ex: svbillabong:20 would get last 20 entries and extract any positions found
  • Options (quess what? they are optional)
    Confusion again: Blogger calls a feed query for labels.. categories
    If options are used a number
    Must be specified ex: username:10:category=Pasta

    • Category: use category=lab1,lab2 to filter by labels
      ex: fromthegalley:10:category=Recipes or fromthegalley:10:Recipes,Pasta
      Note: Labels are Case Sensitive and special characters must be escaped.
    • OrderBy: use orderby=updated to get blogs organized by recent updates instead of blog entry date. Great for updating your old blogs and adding new photos and letting people know what you've been working on lately!!
    • published-min: use published-min=dateTtime to set the minimum published date and time. Only posts that are published after this date will appear in the feed (not updated) . Use the RFC 3339 timestamp, ex: 2005-08-09T10:57:00-08:00.
      YYYY-MM-DDTHH:MM:SSTZ where TZ (timezone) can also be Z
Interactive Examples:
&blogger=svbillabong
A Blogger map for svbillabong.blogspot.com
&blogger=svbillabong&mv=where&mi=in
A Blogger "Where is Billabong?" map with link to latest Blog
&bloggerid=13526182
The same map accessed via BlogId
&blogger=svbillabong:50
The same map but 50 entries
&blogger=sandpiper38:100:category=Indian%20Ocean
Search for Indian Ocean + map locations. Try Indonesia, Mediterranean

Photo Blog Album: &bp=1

No we haven't gone off the deep end. This is a great way to navigate and preview your photo blogs and show the blog location(s) at the same time. If a photo is not found, the blog will not be added to the album. If a location is not available the individual blog map will not appear. Remember we currently use the first photo so make it a good one.
  • Adding &bp=1 to &blogger creates a Photo album of the blog. Any geo-tagged blogs will appear in the summary map and for with individual Blog entry photo.
  • Click the Notes button for a preview of each blog entry.
  • Click the open link button to open the selected blog in a new window
Interactive Examples:
&blogger=fromthegalley&bp=1
A Photo Blog album of FromTheGalley (Try your blogger account)
&blogger=svbillabong&bp=1
A Photo Blog album of svbillabong (the BlurbBits photos are used)
&blogger=fromthegalley:10:category=Recipes,Freezable&bp=1
A Photo Blog Album of from the galley with Freezable & Recipes
&blogger=yachtbalvenie:10&bp=1
A Photo Blog Album of yachtbalvenie
&blogger=yachtbalvenie:10:orderby=updated&bp=1
Yachtbalvenie with recent updates first (notice the photo order)

This format is specific to BlurbBits to define a photo view vs just a simple map view. Within the BlurbsViewr all data is supported (although only those with locations are mapped). Photos will appear in the map tooltip and will be converted to map icons once the tooltip is viewed.

Blogger Photo Size:


Blogger uses the same photo sizes as Picasa for photos that were uploaded to Picasa recently . The bp=1 option can be used with other feeds however photo scaling support is limited to Blogger, Picasa and Flickr (until we add more).

Winlink Quick maps: &winlink=Callsign:number

Do you use winlink to report your yacht's position? Add a quick map, up to your last fifteen position.
  • Callsign is your winlink callsign
  • number is optional and specifies the number of entries to extract. Max is 15.
Interactive Examples:
&winlink=KC0RMX
Map of last 15 locations of callsign
&winlink=KC0RMX:1&mv=where&zooms=13,5&mi=in
Where Map (described below) includes link to winlink interactive map for this callsign

Google spreadsheets: &gss=SpreadsheetId:Number

If you haven't used Google Docs yet, you have to check them out. We use Google Spreadsheets to gain web access to Mapr Scratchpad data.
  • SpreadsheetKey: The Key for your Published spreadsheet.
    When you are editing a document you should see the following path http://spreadsheets.google.com/pub?key=pB293mcNyGGy8SmJCPOwDfQ
    ex: use pB293mcNyGGy8SmJCPOwDfQ
  • number (optional) Specifies the number of entries to extract. The default is all rows.
Interactive Examples:
&gss=pB293mcNyGGyXtOwzu-R5Jg&mark=midredx&smark=smallred&mtitle=Our%20Latest%20Wanderings
Our Latest Wanderings (look familiar)
&mtitle=Uhuru%20Positions&gss=pB293mcNyGGy8SmJCPOwDfQ&mark=midredx&smark=smallred
A friends circumnavigation

GeoRSS Feeds: &gfeed=Path:Number
  • Path: The Url location of an rss feed.
    Note: make sure all Path parameters are escaped (? = %3F and & = %26) or they will be processed incorrectly as BlurbBit/Utility parameters instead of feed parameters.
  • Number: Maximum number of entries (default is based on feed)
  • A fallback for general use
    Feeds vary greatly in their content, format and details so it is almost impossible to design a general feed reader that will handle/format the data in which is optimal for a specific purpose. All of the feeds above started out from a basic GeoRSS feeds and where highly customized based on the desired result and available content.

    We will attempt to extract positions and plot them. However this is an unsupported base format, ie. If it works great.. if it doesn't we're sorry.
  • We will be working hard to add more formats into BlurbBits. If there is something you would like to see please Contact us. We are also available for consulting or custom development.
Interactive Examples:
&gfeed=http://earthquake.usgs.gov/eqcenter/recenteqsww/catalogs/eqs7day-M2.5.xml:50
Last 50 Earthquakes
&gfeed=http://maps.google.com/maps/ms%3Fhl=en%26ie=UTF8%26t=h%26source=embed%26msa=0%26output=georss%26msid=100073405698197242227.00046087dc764f3de70c9
A Google Map RSS feed (escaped). Try your MSID parameter. Use the pp=blog option to re-order the feed if needed.
&gfeed=http://mapnut.com%2Fcalstatepark.xml:50
The first 50 State Parks
&gfeed=http://picasaweb.google.com/data/feed/api/user/SailBillabong%3Fkind=album%26alt=rss
Our Raw Picasa Album Feed

Extracted Map Views: &mv=where
  • where: Map only the last location (i.e. Where are they?)
  • Used with extracted maps
    Creates two zoom levels
    If a link is specified it will appear in the bottom left of the map
  • We will be working on extracting other map views
Interactive Examples:
&blogger=svbillabong&mv=where&mi=in
A Blogger Where map with link to latest Blog
&gfeed=http://earthquake.usgs.gov/eqcenter/recenteqsww/catalogs/eqs7day-M2.5.xml:50&mv=where&mi=in
The Last reported earthquake with link to the detailed page
&gss=pB293mcNyGGyXtOwzu-R5Jg:10&mv=where&zooms=14,8&mi=in&mark=midredx&smark=smallred&mtitle=Our%20Latest%20Wanderings
Where view from Latest wanderings
&mtitle=Uhuru%20Home&gss=pB293mcNyGGy8SmJCPOwDfQ&mark=midredx&smark=smallred
A circumnavigations end point (their start/finish point)

In the BlurbsViewr this will cause the map to zoom to the last entry location (if it has a position).

Using extracted data with BlurbBits Mapr

The extraction methods above (and the photos) also work as parameters to the BlurbBit Mapr. If a location is found it will be placed on the map, otherwise it will appear in the Mapr sidebar list as location unknown (a world with a ?). Clicking on a unplaced entry will add the marker to the map drag cursor which can be dragged into position and placed with a click. You can also find the location first using the Find a Location dialog box, click Go and adjust the maps zoom level to the desired level. Then drag the unplaced entry to the LLZ finder and click to assign its location.

NOTE: This does not and will not modify the source data. You will still need to add the BlurbBit into the original data source (Blog Post), or modify the source directly (photos) .. sorry but we can't do everything. For Picasa album option, the BlurbBit for each album is automatically extracted by default.

This method is also good for testing existing BlurbBits data. If the position doesn't show up in the Mapr when extracted, it wouldn't show up in the extracted BlurbBits.

In this mode the geoRSS feed can be used with NO position data and entries can be dragged onto the map. Save the data to the ScratchPad (text tab format) and upload it (or copy/paste using Ctrl-C Ctrl-V) into a Google Spreadsheet. Follow the extraction steps above and you've got a very quick site navigation map for your geo data using the BlurbsViewr.

Using extracted data with BlurbsViewr

Any of the above examples can be applied to the BlurbsViewr by appending the sample string to the path (don't forget to replace the & with a ?) ie. http://www.creative-cruising.com/blurbbits/blurbsviewr.html?blogger=svbillabong:100
Here's our Sv Billabong Blog in the BlurbsViewr.

Don't forget to increase your feed size if you want all the data mapped. Start with the BlurbBits Mapr to make sure you have some data before proceeding with the Viewr.