×
Namespaces

Variants
Actions
(Difference between revisions)

Archived:Ovi Maps API - Getting the ID of Components attached to a map

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Hamishwillee - Automated change of category from Ovi Maps to Nokia Maps)
jasfox (Talk | contribs)
(Jasfox - Archive)
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:Web]][[Category:Browser]][[Category:Nokia Maps]]
+
[[Category:Nokia Maps]][[Category:JavaScript]]
 +
 
 +
{{Archived|timestamp=20130201151019|user=[[User:Jasfox|Jasfox]]| The Ovi Maps API has been superceded by the Nokia Maps API.
 +
The Nokia Maps API v2 is the successor of the Ovi Maps API. The latest version of the API can be found  [http://developer.here.net/javascript_api here].}}
 +
 
 +
{{ArticleMetaData
 +
|sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
 +
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 +
|devices= Google Chrome 11.0x, Mozilla Firefox 5.0
 +
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
 +
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 +
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 +
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
 +
|signing=<!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 +
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 +
|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
 +
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 +
|translated-by= <!-- [[User:XXXX]] -->
 +
|translated-from-title= <!-- Title only -->
 +
|translated-from-id= <!-- Id of translated revision -->
 +
|review-by=<!-- After re-review: [[User:username]] -->
 +
|review-timestamp= <!-- After re-review: YYYYMMDD -->
 +
|update-by= <!-- After significant update: [[User:username]]-->
 +
|update-timestamp= <!-- After significant update: YYYYMMDD -->
 +
|creationdate=20110621
 +
|author=[[User:Maveric]]
 +
}}
 +
{{SeeAlso|
 +
*  [http://api.maps.nokia.com/en/maps/intro.html Nokia Maps API]  
 +
}}
 +
 
 
==Introduction==
 
==Introduction==
  
Line 21: Line 51:
 
The API reference states:
 
The API reference states:
  
<code java>
+
<code javascript>
getId () : String  
+
getId () : String // Returns a unique identifier of the Component. It is not allowed to add two Components with the same id to a map.  
 
+
Returns a unique identifier of the Component. It is not allowed to add two Components with the same id to a map.  
+
 
</code>
 
</code>
  
So, If previously created a component variable type of Copyright, the getId would return:
+
So, If previously created a component variable type of Copyright, the {{Icode|getId}} would return:
  
<code java>
+
<code javascript>
 
result = component.getId()  
 
result = component.getId()  
 
</code>
 
</code>
Line 39: Line 67:
 
The API reference states:
 
The API reference states:
  
<code java>
+
<code javascript>
 
getVersion () : String  
 
getVersion () : String  
 
</code>
 
</code>
Line 54: Line 82:
 
==For more on Ovi Maps API==
 
==For more on Ovi Maps API==
  
Please check out the Ovi Maps API full documentation and API reference here:
+
For reference the old Ovi Maps API documentation is archived here:
 +
* [http://api.maps.ovi.com Ovi Maps]
 +
 
 +
For the latest Nokia Maps API full documentation and API reference here:
 +
* [http://developer.here.net/javascript_api Nokia Maps API]
  
http://api.maps.ovi.com
+
You may also access the interactive API explorer
 +
* [http://developer.here.net/javascript_api_explorer API explorer]
  
 
==Tested with==
 
==Tested with==

Revision as of 16:00, 3 January 2013


Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

The Ovi Maps API has been superceded by the Nokia Maps API. The Nokia Maps API v2 is the successor of the Ovi Maps API. The latest version of the API can be found here.

Article Metadata
Tested with
Devices(s): Google Chrome 11.0x, Mozilla Firefox 5.0
Article
Created: Maveric (21 Jun 2011)
Last edited: jasfox (03 Jan 2013)
See Also

Contents

Introduction

Within the code, it maybe useful to find out what are the Components that currently are attached to a map display instance.

Prerequisites

Ovi Maps API supported web browser (basically any modern web browser)

The example assumes you have already added the Ovi Maps to your web page as explained in the previous article "Ovi Maps - add the map to any web page"

Important about Maps credentials

With Ovi Maps API you can start without having any credentials given, but you might face a performance gap. In order to get the full potential out of the offering, you must get the credentials that authenticate your application against the Services. Please read through the Location API.

For more information on how to obtain the credentials, please start with the Ovi Maps API Developers Guide section "Acquiring API credentials"

Implementation

The API reference states:

getId () : String // Returns a unique identifier of the Component. It is not allowed to add two Components with the same id to a map.

So, If previously created a component variable type of Copyright, the getId would return:

result = component.getId()

The result would have the value of string "Copyright".

It is also possible to query the component's version.

The API reference states:

getVersion () : String

Returns the version of the component. The version of the component in the format "major.minor.update.revision" where the values may be omitted from right to left. This scheme should be used to make version numbers comparable.

result = component.getVersion


For more on Ovi Maps API

For reference the old Ovi Maps API documentation is archived here:

For the latest Nokia Maps API full documentation and API reference here:

You may also access the interactive API explorer

Tested with

Google Chrome 11.0x Mozilla Firefox 5.0

165 page views in the last 30 days.
×