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).
BlurbBits Mapr Help

BlurbBits Mapr Help


The BlurbBit Mapr Utility has two uses:
  • Create & position multiple standalone BlurbBits
    including photo albums or sets (using extra parameters)
  • Extract & position existing content (from RSS feeds or scratchpad)
Standalone Blurbbits

Each marker or line creates a single BlurbBit which can then be added to a Blog Post, Website or the sidebar (see publishing options). Once this data has been entered it can be extracted and combined together to be displayed in its entirety using BlurbBits or BlurbsViewr. Basically we add BlurbBits to define each posts location (sort of like dropping bread crumbs) and then extract/collect them later if needed.

Existing Content

The extraction options can also be used with BlurbBits Mapr by adding them as Url Parameters (append them to the Mapr Url path starting with ?). Resulting objects can be used to create standalone BlurbBits (described above) and/or saved to the scratchpad and uploaded to the web using Google Spreadsheets. Use can use existing content to quickly build an interactive map of existing content, map existing blog posts, map Picasa web albums or extract existing lat/lng data from geotagged photos. Note: the scratchpad method does NOT modify original source data.

Some Basic Mapr Concepts

The setup map is designed around a right mouse click (RMC) context menu. In most cases this causes a menu to appear with various options based on the object and its current state.

A RMC on the map will allow you to configure the maps click mode (action of the left mouse button), change the maps center and adjust the map based on the LLZ (Lat,Long,Zoom) Locator. By default the click mode is in Normal Mode. You can also use the Edit Selected menu to edit the selected marker or line which is helpful when markers overlap.

LLZ Locator
The LLZ (the blue box) is designed to be moved around to pinpoint a location and zoom level. Once the location is correct use RMC options to: add a new marker, add it to an existing line or center the map at its location. You can also move an existing marker to by using Marker RMC->Snap to LLZ. Note: You can alway re-center the LLZ at anytime by clicking the Move button next to the Center Lat,lng,Zoom field.

Marker

When the map is in Add Marker mode, a left mouse click will add the marker to the clicked location and store the maps current zoom level. A marker RMC menu has options to: edit properties, set zoom level, enable/disable drag (for positioning), snap to LLZ and delete object. Clicking on a marker at any time will re-center the map to its stored location and zoom level, the basis of the BlurbBit map. If the markers Drag Mode is enabled (default for new markers), the marker can be dragged to a new location with the left mouse.

Line

The line RMC menu has options to: edit properties, insert a point, disable edit mode and delete object. To add a line, first set the map to Add Line mode, then click the map to add points using a RMC to finish (or re-click the last point added). Editing a existing Line: A line can be re-shaped by moving the mouse over the line and dragging the segment end or mid point to a new position. A RMC on a segment end point will remove it from the line. Append points to the selected line by setting the map to Append to Line mode and clicking the map, a marker or the LLZ. The LLZ locator can be added to a selected line in any map mode (RMC->Add To Line).

Moving about the map

The map can be dragged with the left mouse or by using the pan controls on the top left. The map can be Zoomed by using the zoom scale on the left side, double clicking left mouse (zoom in), double click right mouse (zoom out), or by using the mouse scroll wheel (if it has one). Selecting a marker will center the map at its position and zoom level, while selecting a line will center the map to display it bounds.

Finding a Location


For all you landlubbers, enter the address, city and/or country you are trying to find in the location text box and click 'Go'. If the location cannot be found try refining the search string or starting at the Country, State or Region level. If found, the LLZ locator will move to the location and zoom level. Then you can modify the zoom, adjust the position and add it to a line or create a new marker. Please note that we all share this service and it is meant to only be used occasionally and certainly not for batch geo-coding. There are plenty of better and faster ways to batch geocode data (see batchgeocode.com/). See our examples on how to get lat/lng data from Wikipedia (good for tourist locations) or by extracting the data from geotagged photos (from a mobile device or automatic geotagging software).

If you are a sailor like us, you'll find lat/long values the easiest way to enter data. You can enter the comma separated lat,long (and optional zoom) values in either the Center Lat,Lng,Z text field or the LLZ text field.

Don't forget that markers also include a zoom value. Selecting a Marker on the map or in the select list will cause the map to center and zoom to the markers location and zoom level. An individual BlurbBit map will be centered at this view. You can use the Marker RMC Set Zoom to update the marker to the maps current zoom level (or enter it manually via the Edit Object - Zoom).

Designing a BlurbBit


Choose your Design Size, configure your extras and then click the Preview BlurbBit button. This will popup a preview of the BlurbBit in a design mode. Once you have checked the various features and map zoom levels, select the Info button for the installation options. Use the X button in the upper right corner to close the preview window.

Choosing a Design Size

Note: The Design Size can effect photo load times dramatically. The default sizes were chosen to optimize the available photos, and the square shape supports both Horizontal and Vertical orientation. If only a map is used or the photos are in a single orientation, the width and height can be manually adjusted.

Extras

Markers and lines are really just the start, and we only talk about them first because we're talking about the BlurbBits Mapr so we figured you wanted a map. In the BlurbBits Mapr, extras cover the things that aren't described by the basic line or marker object. Extras can be extracted and entered much easier than drawing a line or figuring out the zoom level of the Boston area you are interested in without a map.

Hey what are all those funny ? and & signs I'm seeing?
Make sure you start with Create a BlurbBit
Extras can be used to configure the marker size and color, add photos, and various viewing/configuration options. These can be entered directly as a property of an Object (via BlurbBits property RMC->Edit Properties or the Scratchpad) or quickly entered directly into the Extras box. If an object has no prior BlurbBits definition it will be stored when the object is previewed. The next time the object is selected and previewed, the saved version is shown (good for double checking or storing and retrieving via the ScratchPad). The Update option enables you to quickly prototype different BlurbBits and will update the stored value from the Extras box.

Once you feel comfortable with the available options you can easily configure BlurbBits in the browsers Url Location window (use the design mode to get installation options).

More Details on Extra Options
Preview your BlurbBit

The Show Map button determines if the BlurbBit should include a map. This should be disabled for certain extras that automatically extract a map. The Use Label button allows the map title to be set to the Blurbs label.

Preview the configured BlurbBit and make sure you check each view. Once satisfied, choose your Publishing Option from the BlurbBit's preview i (info) menu. If you are not seeing the changes make sure you have the Update toggle set.

Line Properties
  • Color Name or #Ref (default is red)
    -Name: is one of the set {black, green, silver, lime, gray, olive, white, yellow, maroon, navy, red, blue, purple, teal, fuchsia, aqua}
    -#RGB: six digit hex triplet for RGB #ffff00 is yellow, #000000 is black,#ffffff is white
  • Width Width
    Width: Line width in Pixels (default is 2)
  • Opacity Num
    Num: Opacity value within range 0-1 where 1 solid, 0 invisible (default is 1)
Adding Routes/Paths to Locations

For geotagging, the most important item a BlurbBit can have is a Location (via llz ie. a Marker) but lines are great for showing your route or plans. We just don't know what you want to show: the start point, the end point or the center with a zoom that shows the entire route. The easiest way to show both is to use the Marker as your "master" and use a second line to draw the path.

Select the line and copy the path= section of the text box that appears besides the Preview BlurbBit button. Select the Marker, add a & with the path section you just copied into the extras box. If you've already stored a BlurbBit for the Marker, make sure you preview the old version first (which copies the stored value to the extras buffer), then add your line and set the Update toggle.

Most geotagged data will only have a single location, this method can be used to add paths to photo albums, sets and other marker. Don't forget to save the data with the ScratchPad for re-use, we don't extract data from the result path statements.

The ScratchPad


The scratchpad can be used to save the data you create/map; to re-used within the Mapr to adjust BlurbBits or to upload to the web for use with Google Spreadsheets (and extracted for utilites). It is also MUCH easier to cut/paste data into the ScratchPad than into dialog boxes one-by-one. Note: we don't store the data for you anywhere. Data loaded from the scratchpad with Load from ScratchPad replaces all existing Mapr data (changes will be lost).

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. Use the | separated text file for quickly entering data in a text editor (like notepad) and tab separated for importing into text editor (like notepad), spreadsheets or table editors. Each line represents an object (objects cannot span multiple lines).

Using Google SpreadSheet (GSS)



By uploading the data to a Google Spreadsheet you allow web access to the scratchpad data. You can then use the Google Spreadsheet extraction parameters to view your data in BlurbBits and utilities.

Login to Google Docs. Create a New Spreadsheet by selecting the New-Spreadsheet menu, this will open an Unamed Spreadsheet in a new window AND access the spreadsheet portion of Google Docs (you can also open an existing spreadsheet). Use the File-Import menu to upload the saved scratchpad text document from your computer. You can adjust the column widths to make it easier to read/modify data. Caution: If you just try to upload (instead of import) a plain text file (.txt) it will open incorrectly as a standard document. Tab separated text files (.tsv) will upload correctly as a spreadsheet.

Publish GSS

Use Share-Publish As Web Page and then Publish Now to share the data and allow BlurbBits web access to it. Check the "Automatically re-publish.." toggle to allow all changes to be passed to BlurbBits. Use the key=xxxyyyzzz value of the Your document is viewable at: link for the Google Spreadsheet extract parameter for BlurbBits or other utilities (ie. &gss=xxxyyyzzz).
Here's an example result in the Interactive Blog Map (new window) along with the Published Google Spreadsheet File.

If you want to make changes to THIS data with a new scratchpad file, use File-Upload New Version.. or edit the Google Spreadsheet manually. You can quickly copy rows from the scratchpad by copying and pasting into the spreadsheet using Ctrl-V. Note: if you are not familiar with Google Docs, please use the help that is available through their online support. We cannot provide help on end applications in addition to advancing the development of BlurbBits and related products.

Command Options:

You can also specify commands which combine BlurbBit extraction types. This is useful for combining historical Mapr data with new BlurbBits enhanced feeds.

Note these commands will not work within the ScratchPad but can be used in data passed into the Mapr.
  • bbext|extract-cmd: extract blurbs and add to list (in order)
  • bbext+|extract-cmd: extract and add to beginning of the list
  • sort|type: where type is the date sort format
    either blog (latest first) or journal (latest last).
Examples:

Add Paths to our Albums (see example file)
TYPE|LLZ|LABEL|BLURBBIT|URL|DESC|IMAGE|DATE|TRIP|EXTRA|LINEPTS
L||Route 2008||||||0|gray,2,1|7.78,98.3+7.62,92.61..
extbb+|picaalbums=SailBillabong


Combine blogs and photos and sorts them by date
extbb|picasa=SailBillabong::max-results=200
extbb|blogger=svbillabong:100
sort|blog

Add the latest blogs to our historically placed Mapr data AND routes (see example file)
extbb+|blogger=svbillabong:50:published-min=2008-10-30T10:18:00Z
B|36.24,29.985,12|The Truth ..|2008-Oct-30 09:18Z
B|36.289269,30.075920,12|The Lycian...


Note: Combining too many sources or extracting too many items from a single feed can dramatically slow down your load time. If you load a spreadsheet with commands into the mapr, the expanded results will appear.

ScratchPad Uses

You can also use this a simple format to start your BlurbBits when you are not online or create a quick travel log (sample file), objects do not need a llz. Create a couple of each object type and get a good understanding using the dialog boxes first. Then save them to the scratch pad and use this a template for future BlurbBits. Have a blast!! Note: if you have email access while offline it is much easier to Moblog.

Note: watch out for Microsoft Excel, it does some auto formatting of dates and numbers and sometimes it won't let you save the data back out into tab format (nice huh?). It is best to use the File->Open option which triggers the Text Import Wizard where you can configure each column type (general will auto-convert - text will NOT).

Scratchpad Column Details

Currently this format is designed specifically for saving to and from the ScratchPad and NOT for converting other data sources, unknown column headers will be ignored and deleted. Column headers must be formatted as shown (i.e. there is no mapping GUI). In the Google Spreadsheet empty rows cause problems. Columns can be any order however the TYPE statement must be the first column. Be careful when combining multiple data sets i.e. make sure the columns are in the same order.

Ex: (text | mode)
TYPE|LLZ|LABEL|BLURBBIT|URL|DESC|IMAGE|DATE|TRIP|EXTRA|LINEPTS
R|36.38591,30.12451,6|Sample-Marker|&picasa=SailBillabong
L|36.84535,30.25635,7|Sample-Line||||||0|red,2,1|35.74651,29.64111+37.31775,28.67432+37.9442,30.84961+36.35053,31.83838+36.31513,30.58594

TYPE: From the Set {R,J,B,A,P,V,K,L}

This is used to define the type of each blurb. In most cases this just changes the marker icon. In the future we will have a user defined set of types available but first we need to "roll it out" into the various utilities.
  • R: Location Report (general use)
  • J: Journal
  • B: Blog
  • A: Photo Album (Picasa Album, Flickr Set link of your own photo collection page.
  • P: Individual Photo
  • V: Video
  • K: KML/KMZ file Only used within BlurbsViewr and BlurbBits mapr.
    The specified KML Data should contain only line (<linestring>) or drawn data and not markers. Access to the KML marker information via the Google Maps API is non existent so any marker (and resulting info windows) will be outside the scope of our tool and will most likely confuse the end user. We are working on a KML extraction utility to get KML content into BlurbBits. In the mean time you can use the Mapr to roughly trace your complex KML lines (This example has both KML GPS tracks and simple lines). Contact Us to let us know it's important (and to give us feedback.. please). Tracing hint: because the KML layer clicks cannot be controlled, clicking on a KML line will cause an info window to appear. This makes it impossible to actually start drawing the line directly on the KML line. Start by clicking near the line and then trace, when finished drag the initial point onto the line.
    To access a Google My Maps KML File use the Url provided by the View in Google Earth button or change the &output=embed to &output=kml in your Google Map embed src= code. ex: http://www.google.com/maps..&output=kml.
  • L: A line/route/path or track. Best drawn via the BlurbsMapr utility. Use &rpoly=true to round values to two decimal places for the resulting BlurbBit (this reserves URL line length without effecting overall path description.. for large scale paths).
There is also a Trip mode that can be used to automatically generate Trip Tracking paths from your geotagged data. To enable use &tt=travel on either the BlurbsViewr or BlurbBits mapr. In the mapr the Travel Tracks will be updated each time the data is saved and reloaded via the ScratchPad. Please consider this a prototype feature as we have yet to add the definition capabilities to an individual BlurbBit.

X: add to the Travel Track Line (no tooltip or preview.. only position)
T: Starts a New Trip (uses the defined line definition and traces all subsequent points to build a path)
L+,L- more details to follow.. adds a drawn line to the Travel Track.

See a modern version of Billabong's Latest Wanderings. All the Travel Tracks (ie. lines) except the KML track were calculated using this method, which also calculates the travel distance.

LLZ: Lat,Lng,Zoom See Specifying a Location
We also support separate LAT,LNG,ZOOM colums which will be combined to create an LLZ column. (with LLZ the ,zoom value is option and will support Lat,Lng).

LABEL: The label (i.e title, caption) for this entry.

BLURBBIT: The pre-defined extra portion for this type.

Make sure you don't try and overwrite the main object parameters (llz, line pts etc), this is for the extra parameters only.

URL: Path,Label

Will be used to link to a webpage or specific blog in interactive modes (i.e. where do we go when a user clicks).
  • Path: The URL for a webpage
    ex: http://www.blurbbits.blogspot.com
  • Label: Optional Label will be used when building links (default is the label)
    ex: http://www.blurbbits.blogspot.com,this site
DESC: The content description for this entry.

Currently all HTML tags are stripped from this field (thanks hackers). We will be implementing a formating process as soon as we completely understand the issues and solutions.

IMAGE: ImgUrl,Caption

Will be used for the Image when referencing this entry.
  • ImgPath: The URL for an Image
    ex: http://www.blurbbits.blogspot.com/SomeImage
  • Caption: Optional caption will be used when building links to Image (default is the label)
    ex: http://www.blurbbits.blogspot.com/SomeImage,This Blog Image
Note: You must have rights to display and use the image. If you are creating these from scratch make sure you understand the rules of each data source.. i.e. Flickr requires a link back to the source photograph on Flickr.

DATE: YYYY-Mon-DD HH:MM or YYYY-MM-DD HH:MMZ

These are the only acceptable Date formats which are currently extracted from feeds and could be used in the future to sort by date for combining various data sources. Time should be specified in Greenwich Mean Time (GMT or Z) and is Optional. Note most cameras don't store time zone so GMT conversion is NOT critical, heck most people don't have the right year on their camera, let alone time.
  • YYYY-Mon-DD HH:MMZ
    Where Mon is from the set {Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec}
    Ex: 2004-Apr-18 06:43Z
  • YYYY-MM-DD HH:MMZ a T is optional between date and Time
    Ex: 2004-04-18 06:43Z or 2004-04-18T06:43Z
TRIP: AddTo

Will be used in the future to create Trip Tracks (need to extend definition to BlurbBits)
  • AddTo: from the set {" ",0,1,2}
    " ": space- Use map default
    0: don't include in Trip Track (use for separate "overview" content)
    1: Add to Trip Track (keep as blank for now)
    2: Add to Trip Route as Day Trip (out to location and then back)
EXTRA: Guess What? Here's where the Extra stuff goes.

Depending on the TYPE parameter different content is stored here.
  • L: Line style parameters color,width,opacity ex: red,2,1
  • K: KML/KMZ Url filename ex: http://www.creative-cruising.com/Billabong-Tracking/Billabongs-Sailing-Summary.kml
LINEPTS: The point defintions of a line + seperated.

It's easier to draw lines in the mapr.

Examples:

For a full example try loading our Blogger feed (?blogger=svbillabong) and then save the data to the ScratchPad. Draw some lines and store a couple of your own markers to get the full example and understanding of the data set.

Options Specific to BlurbsViewr:

tt:travel

Configures the Travel Tracker Display Mode, can also be configured via the URL parameter &tt=travel;