maps

To link against this class, add the following line to your .pro file: LIBS += -lbbcascadesmaps

Classes

BlankRenderEngine

An empty render engine, which will be used when no other engine can be found.

DataProvider

A source of mappable data.

MapData

A collection of data providers to be represented on a map.

MapImageGenerator

A generator which makes an asynchronous request for a map image.

MapLongPressToPinDrop

A utility action class for performing a pin drop, which is the creation of a new point of interest (pin) triggered by a user's action.

MapView

A graphics user interface (GUI) control that displays a map along with user-defined geographic elements, which can be points of interest or other location-aware elements.

RenderEngine

The common interface for all rendering engine implementations.

RenderEngineConfiguration

Configuration information that's passed to a RenderEngine upon initialization.

RenderEngineInfo

The characteristics of a render engine.

ViewProperties

The properties of the current view.

Functions Index

BB_CASCADES_MAPS_EXPORT bb::cascades::maps::DataProvider *convertKmlContentToDataProvider (const QString &kmlContent)
BB_CASCADES_MAPS_EXPORT bb::ImageDatagenerateMapImage (const bb::cascades::maps::ViewProperties &viewProperties)
BB_CASCADES_MAPS_EXPORT bb::ImageDatagenerateMapImage (const bb::cascades::maps::ViewProperties &viewProperties, const bb::platform::geo::GeoList &data)
BB_CASCADES_MAPS_EXPORT QStringgenerateMapUrl (const bb::cascades::maps::ViewProperties &viewProperties, const QString &label)
BB_CASCADES_MAPS_EXPORT QDebugoperator<< (QDebug dbg, ViewProperties const &src)

Functions

BB_CASCADES_MAPS_EXPORT bb::cascades::maps::DataProvider * convertKmlContentToDataProvider (

Converts KML data content into a DataProvider.

The @c DataProvider instance contains various geographic elements that are created as a result of parsing this KML content. Its ID is set to the unique ID available within the KML content itself. The returned object is owned by the calling client, which must delete the associated memory. Note, when the returned object is passing a @c MapData instance, then that @c MapData becomes the owner of the return, and the deletion of memory is handled by the @c MapData.

Parameters
kmlContent

The KML content ready to be parsed.

Return:

The DataProvider instance that holds the geographic entities that correspond to the KML data, or NULL if an error occurred during the parsing of KML content. If no supported geographic elements were encountered (e.g. Placemarks), but the parsing itself was successful, then an empty data provider is returned.

Since:

BlackBerry 10.0.0

BB_CASCADES_MAPS_EXPORT bb::ImageData generateMapImage (

Generates a map image.

The location, zoom level and image size are determined by viewProperties. This is a blocking function that may require network access.

The following is an example of how to generate a 200px x 200px high-level view of Toronto, Ontario, Canada:

bb::cascades::maps::ViewProperties prop;
prop.setAltitude(75000);
prop.setLatitude(43.670161);
prop.setLongitude(-79.386881);
QRect size(0, 0, 200, 200);
prop.setWindow(size);
bb::ImageData imgData = bb::cascades::maps::generateMapImage(prop);
bb::cascades::Image img(imgData);
Parameters
viewProperties

The information describing the location to generate a map image of.

Return:

The image data for the map image. If bb::ImageData::isValid() returns false, there was an error generating the image.

Since:

BlackBerry 10.0.0

BB_CASCADES_MAPS_EXPORT bb::ImageData generateMapImage (

Generates a map image with provided Geographic data on it.

The location, zoom level and image size are determined by viewProperties. This is a blocking function that may require network access.

Parameters
viewProperties

The information describing the location to generate a map image of.

data

List of Geographics to be placed on the map.

Return:

The image data for the map image. If bb::ImageData::isValid() returns false there was an error generating the image.

Since:

BlackBerry 10.0.0

BB_CASCADES_MAPS_EXPORT QString generateMapUrl (

Generates a URL encapsulating the map defined by the given ViewProperties.

Parameters
viewProperties

The ViewProperties describing the area to encode in the URL.

label

The label of the location in the center of the map, or an empty string for no label.
Return:

The URL.

Since:

BlackBerry 10.0.0

BB_CASCADES_MAPS_EXPORT QDebug operator<< (