Introducing Mapsicle – a Street View library

Ever since Street View came out in New Zealand, we’ve been itching to play around with StreetView. As part of our Summer of Code project, Stephen built Street View prototype called Mapsicle. Since then Mapsicle became a pet R&D project at ProjectX.

Today, we’d like to announce the V1 release of Mapsicle as part of the Gmaps-util library.

What can you do with Mapsicle?

Using Mapsicle library, you can do a lot of interesting things:


  • Create and show markers at various locations on Street View like at Disneyland Paris


  • Show markers that are outside of the field of view like the NZ flag marker above.


  • Create info-windows at locations.

Getting started

Getting started on Mapiscle is really easy. To add Mapsicle to any page simply:

  1. Download the library from SVN for Gmaps-utils library .
  2. Include the mapsicle.js in the document header
  3. <script src="mapsicle.js" type="text/javascript"></script>
  4. Define a ‘div’ element on your page to contain the Mapsicle object
  5. <div id="mapsicle_div" style="width:600px;height:400px;"></div>
  6. On the page load event, create a new Mapsicle object, with the first param being the id of the container ‘div’ element,
    and the second being the init a GLatLng object for the inital location.
  7. function init(){
        var mapsicle = new Mapsicle("mapsicle_div", new GLatLng(-41.292579, 174.779075));

Simple Example

This example shows the basics of adding a marker and location to the Mapsicle view.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "">
<html xmlns="" xml:lang="en" lang="en">

        <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
        <script type="text/javascript" src=""></script>

        <script type="text/javascript">
        <script type="text/javascript" src="mapsicle.js"></script>

        <script type="text/javascript">
            function init(){
                var mapsicle = new Mapsicle("mapsicle_div", new GLatLng(-41.292579, 174.779075));
                var marker =  new SVMarker({
                var location = new SVLocation({
    <body onload="init();" onunload="GUnload()">

        <div id="mapsicle_div" style="width:850px;height:400px;"></div>

View example (simple_demo.html).

Mapiscle possibilities

We believe there are loads of possibilities in the types of mashups and map applications that you can now create with Mapsicle. Add to that  to the Street View partner program, and Mapsicle will help to launch a new generation of mashups.

Here are some ideas :

  • Annotate locations – Need to annonate a building or a place now you can like or demo –
  • Advanced Store locators – Create store locators showing you exactly how to get to your store from their current location.
  • Interactive tours – Combine Street View with content to show people interactive tours of the streets of the world.
  • Interative kiosk – What about Street View as a touch screen information kiosk.
  • Digital signage – Create interactive advertising on Street View using video and images.
  • Games – Build a treasure hunt application or what a game to drive around Thunderhill raceway ?
  • Mashups – How about adding Street View to your mashup ?


It is early days for the library, and we have a bunch of features that we are working enhance what you can do with Street View. You can contribute and enhance Street View as part of the Google Maps Utility library. We’d really love your feedback to help us improve Mapsicle and build more cool apps for the Google maps platform.

2 Responses to “Introducing Mapsicle – a Street View library”

  1. Dive into the map » Blog Archive » Augmented Reality - A new interface to search, explore and discover Says:

    […] if you don’t mind the time gap between now and when the images were taken, then Mapsicle, a cool new Street View library developed by New Zealand company ProjectX, will enable you to create and experience armchair […]

  2. hypertexture » Blog Archive » Streettag – Tagging Google Streetview and more… Says:

    […] see: and ] Share and […]

Leave a Reply