XML element: <location>

The <location> element contains information for a specific location. The description, label, x and y are required attributes.

Valid parents

<lbs>, <getRoute>

Valid children

None

Attributes

Attribute

Type

Description

Supported in

address

String

This attribute specifies the street address.

BlackBerry® Java® Development Environment 4.2.1 or later

categories

String

This attribute specifies the category.

BlackBerry JDE 4.2.1 or later

city

String

This attribute specifies the city.

BlackBerry JDE 4.2.1 or later

country

String

This attribute specifies the country.

BlackBerry JDE 4.2.1 or later

description

String

This attribute specifies the description information for a location.

This is a required attribute.

BlackBerry JDE 4.2.0 or later

email

String

This attribute specifies the email address.

BlackBerry JDE 4.2.1 or later

fax

String

This attribute specifies the fax number.

BlackBerry JDE 4.2.1 or later

label

String

This attribute specifies the label that is displayed beside a location on a map.

This is a required attribute.

BlackBerry JDE 4.2.0 or later

phone

String

This attribute specifies the phone number.

BlackBerry JDE 4.2.1 or later

postalCode

String

This attribute specifies the postal code or zip code.

BlackBerry JDE 4.2.1 or later

rating

double

This attribute specifies the rating information in the range of 0 to 5.

BlackBerry JDE 4.2.1 or later

region

String

This attribute specifies the province or state.

BlackBerry JDE 4.2.1 or later

url

String

This attribute specifies the URL.

BlackBerry JDE 4.2.1 or later

x or the alias, lon

integer

This attribute specifies the longitude in decimal degrees with five decimal accuracy multiplied by 100,000.

This is a required attribute.

BlackBerry JDE 4.2.0 or later

y or the alias, lat

integer

This attribute specifies the latitude in decimal degrees with five decimal accuracy multiplied by 100,000.

This is a required attribute.

BlackBerry JDE 4.2.0 or later

zoom

integer

This attribute specifies the zoom level from 0 to 15.

BlackBerry JDE 4.2.0 or later

Code sample

<lbs id='Waterloo'>
    <location x='-8052237' y='4346518'
      label='Waterloo, ON' description='Waterloo' zoom='10' />
</lbs>

Was this information helpful? Send us your comments.