Figure 1: Location Centre Registration API element diagram
This API is targeted for use by a location-based service, which is to be available from Location Centre. Location Centre is the collection of location-based services and it allows client applications to read this list, launch a service from the list or show a pop-up query UI for the user to select a service to be launched. Clients use these features via Location Centre API. The user can also see the list of location-based services and launch one of them via dedicated Location Centre application from terminal's Application Shell (however, such an application is optional).
Location-based services can be represented by applications, web sites, documents, etc. Both built-in and post-installed services can be registered in and accessed via Location Center.
This API defines XML-based registration file, which describes the service in question. It also specifies how the file should be published to make the registration.
This API provides the following use cases:
The API is not based on C++ classes, but defines XML Schema, which registration files must comply with. Below is the XML diagram, which illustrates the logical structure of all the elements defined by this API.
Figure 1: Location Centre Registration API element diagram
On this diagram (and diagrams further in the document), icons, like the
one between root element and service, represent XML sequence,
which means that the items behind it should be listed in the shown order.
Icons, like the one in front of application, webService and document,
represent the XML choice, which means that only one of the items behind it
can be used. Items (tags and attributes) in the solid line frames are mandatory.
Optional items and attributes are depicted by dashed connection lines and
frames (not applied to dashed frames around types). Items, which can be repeated
are drawn in double frames with range subnotes (see name and feature,
for example).
All of these elements and attributes are described in the next chapters.
