Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

..
Failed to load latest commit information.
www Moved config.xml to root as per Cordova changes
LICENSE
README.md
config.xml
screenshot_maps.jpg

README.md

Maps Sample

This sample demonstrates how to integrate a few popular mapping services into a BlackBerry WebWorks application for BlackBerry 10.

The sample code for this application is Open Source under the Apache 2.0 License.

Applies To

Author(s)

Screenshot

image

Dependencies

  1. jquery-1.7.2.js is dual licensed under the MIT or GPL Version 2 licenses.

  2. bbUI.js is licensed under the Apache 2.0 license.

Icons
Icons used here are from http://subway.pixle.pl/rim are licensed under the CC-BY-3.0 license. This is a subset of the Subway icons available at http://subway.pixle.pl/

Demo Video
Check-out the demo video on the BlackBerry DevTube Channel.

To contribute code to this repository you must be signed up as an official contributor.

Initial Setup

**To use this sample, you must sign up for API keys from the service you wish to use. The links below will point you in the right direction. **

Google Maps
Bing Maps
Leaflet via CloudMade
OpenLayers

Add your API Keys

Open js/maps.js and enter your API Keys in the proper place

function initApp() {

  APIKey = {
    'bing': '<my bing key>',
    'leaflet': '<my leafleft/cloudmade key>'
  };

  console.log('app initialized');
  startGeolocation();
}

Config.xml

All domains you plan on making Ajax/XHR requests to must be whitelisted in your app's config.xml.

<access uri="http://virtualearth.net" subdomains="true" />
<access uri="http://bing.net" subdomains="true" />

Don't forget to access the devices location information via HTML5 Geolocation, the proper permissions must be requested.

<rim:permissions>
    <rim:permit>access_location_services</rim:permit>
</rim:permissions>

Security Considerations

Your API Keys are meant to be private. For demonstration purposes we're coding the keys right in the JavaScript source. This is not best practice, and is not recommended. You don�t want anybody to get access to your keys.

One way to securely pass your API Keys to your application is to host them on a server, then use SSL and do a POST to obtain your keys.

How to Build

  1. Clone this repo to your local machine.

  2. Ensure the BlackBerry 10 WebWorks SDK 2.0 is correctly installed.

  3. Open a command prompt (windows) or terminal (mac) and run the following command:

    webworks create <your source folder>\Maps
    
  4. Replace the default Maps\www folder with the \www folder from this project

  5. Replace the default Maps\config.xml with the config.xml from this project

  6. From the command prompt (Windows) or terminal (mac), navigate to the Avatar-Booth folder

    cd <your source folder>\Maps
    
  7. Run the following commands to configure plugins used by this app

    webworks plugin add com.blackberry.app
    
  8. Run the following command to build and deploy the app to a device connected via USB

    webworks run
    

More Info

Contributing Changes

Please see the README of the BB10-WebWorks-Samples repository for instructions on how to add new Samples or make modifications to existing Samples.

Bug Reporting and Feature Requests

If you find a bug in a Sample, or have an enhancement request, simply file an Issue for the Sample.

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Something went wrong with that request. Please try again.