--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
+<meta http-equiv="X-UA-Compatible" content="IE=9" />
+<link rel="stylesheet" type="text/css" href="../../css/styles.css" />
+<link rel="stylesheet" type="text/css" href="../../css/snippet.css" />
+<script type="text/javascript" src="../../scripts/snippet.js"></script>
+<script type="text/javascript" src="../../scripts/jquery.util.js" charset="utf-8"></script>
+<script type="text/javascript" src="../../scripts/common.js" charset="utf-8"></script>
+<script type="text/javascript" src="../../scripts/core.js" charset="utf-8"></script>
+<script type="text/javascript" src="../../scripts/search.js" charset="utf-8"></script>
+<title>Getting HERE Maps Credentials</title>
+</head>
+
+<body onload="prettyPrint()" style="overflow: auto;">
+ <div id="toc-navigation">
+
+ <div id="toc_border">
+ <div id="toc">
+ <p class="toc-title">Dependencies</p>
+ <ul class="toc">
+ <li>Tizen 4.0 and Higher</li>
+ </ul>
+ <p class="toc-title">Related Info</p>
+ <ul class="toc">
+ <li><a href="https://developer.tizen.org/dev-guide/csapi/namespaceTizen_1_1Maps.html">Tizen.Maps Namespace</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+
+ <div id="container"><div id="contents"><div class="content">
+
+<h1>Getting HERE Maps Credentials</h1>
+
+<p>The HERE Maps Plug-in for the Maps Service API is based on the HERE Maps services. It is provided as an example in the Tizen platform, and to use it on the HERE Maps, you need credentials for it.</p>
+
+<p>You can select HERE plans depending on the number of request queries and the kind of supported features you need, and pay for them accordingly. The following instructions provide a summary of how to get new credentials. For more information, see <a href="https://developer.here.com" target="_blank">HERE Developers</a>.</p>
+
+<p>To get credentials:</p>
+
+<ol>
+<li>Go to the <a href="https://developer.here.com" target="_blank">HERE Developers</a> Web site and sign in.
+
+ <p>If you have no account, first register for the HERE Maps account.</p>
+</li>
+
+<li>Select a plan for using the HERE Maps services, and register a new project.
+
+ <p>You can select between various <a href="https://developer.here.com/plans" target="_blank">public or business plans</a>. Signing up for a plan automatically registers a new project.</p>
+ <ol type="a">
+ <li>Select the plan that meets your requirements for the number of transactions you need, and click <strong>Sign up</strong>.</li>
+ <li>Provide your contact details, and agree to the terms and conditions.
+ <div class="note">
+ <strong>Note</strong>
+ The registration does not support some regions and countries. If your contact details contain such a region or country, you cannot register a new application.
+ </div>
+ </li>
+ </ol>
+</li>
+<li>Generate the credentials.
+ <p>To access the new project, select <strong>Projects</strong> in the drop-down menu next to your user name in the upper-right corner of the screen, and click the project in the project list.</p>
+ <p>To generate the credentials, click <strong>Generate App ID and App Code</strong>.</p>
+</li>
+
+<li>Use the credentials in your application.
+ <p>You can use the credentials in your application with the <a href="https://developer.tizen.org/dev-guide/csapi/classTizen_1_1Maps_1_1MapService.html">Tizen.Maps.MapService</a> class.</p>
+ <p>The HERE Maps services provide 2 values as credentials: app ID and app code. If the app ID is <code>XXXX</code> and the app code is <code>YYYY</code>, concatenate them with the "/" separator:</p>
+
+<pre class="prettyprint">
+var maps = new MapService("HERE", "XXXX/YYYY");
+</pre>
+
+
+ <div class="note">
+ <strong>Note</strong>
+ According to the HERE Maps:
+ <ul>
+ <li>The app ID uniquely identifies your application.</li>
+ <li>The app code is used in the authentication process to identify a session.</li>
+ </ul>
+ </div>
+
+</li>
+</ol>
+
+
+<script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
+<script type="text/javascript" src="../../scripts/showhide.js"></script>
+</div></div></div>
+<a class="top sms" href="#"><img src="../../images/btn_top.gif" alt="Go to top" /></a>
+<div id="footer">
+ <p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>
+</div>
+
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-25976949-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+</script>
+</body>
+</html>
+
<p id="supported_maps">The following map providers are supported:</p>
<ul>
<li><a href="https://developer.here.com" target="_blank">HERE Maps</a> based on the <a href="https://developer.here.com/rest-apis" target="_blank">HERE REST API</a>.
- <p>To use the HERE Maps, set the provider name to "HERE" and <a href="../../native/location_sensors/here_credentials_n.htm">get the HERE API keys</a>.</p></li>
+ <p>To use the HERE Maps, set the provider name to "HERE" and <a href="here_credentials_n.htm">get the HERE API keys</a>.</p></li>
<li><a href="https://mapzen.com" target="_blank">Mapzen Maps</a> based on Mapzen services.
- <p>To use the Mapzen Maps, set the provider name to "MAPZEN" and <a href="../../native/location_sensors/mapzen_credentials_n.htm">get the Mapzen API keys</a>.</p></li>
+ <p>To use the Mapzen Maps, set the provider name to "MAPZEN" and <a href="mapzen_credentials_n.htm">get the Mapzen API keys</a>.</p></li>
</ul>
<a class="top sms" href="#"><img src="../../images/btn_top.gif" alt="Go to top" /></a>
-<div id="footer"><p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">
Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>
+<div id="footer"><p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>
</div>
<script type="text/javascript">
--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
+<meta http-equiv="X-UA-Compatible" content="IE=9" />
+<link rel="stylesheet" type="text/css" href="../../css/styles.css" />
+<link rel="stylesheet" type="text/css" href="../../css/snippet.css" />
+<script type="text/javascript" src="../../scripts/snippet.js"></script>
+<script type="text/javascript" src="../../scripts/jquery.util.js" charset="utf-8"></script>
+<script type="text/javascript" src="../../scripts/common.js" charset="utf-8"></script>
+<script type="text/javascript" src="../../scripts/core.js" charset="utf-8"></script>
+<script type="text/javascript" src="../../scripts/search.js" charset="utf-8"></script>
+<title>Getting a Mapzen API Key</title>
+</head>
+
+<body onload="prettyPrint()" style="overflow: auto;">
+<div id="toc-navigation">
+
+ <div id="toc_border">
+ <div id="toc">
+ <p class="toc-title">Dependencies</p>
+ <ul class="toc">
+ <li>Tizen 4.0 and Higher</li>
+ </ul>
+ <p class="toc-title">Content</p>
+ <ul class="toc">
+ <li><a href="#rate_limit">API Rate Limits</a></li>
+ <li><a href="#check">API Usage Check</a></li>
+ </ul>
+ <p class="toc-title">Related Info</p>
+ <ul class="toc">
+ <li><a href="https://developer.tizen.org/dev-guide/csapi/namespaceTizen_1_1Maps.html">Tizen.Maps Namespace</a></li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+ <div id="container"><div id="contents"><div class="content">
+
+<h1>Getting a Mapzen API Key</h1>
+
+<p>Mapzen products help you put a map anywhere, search and route the planet, and try a world of open data. They are built from open-source tools that are packaged into a Web service and hosted on the Mapzen servers. If you want to use Mapzen services, you must create a Mapzen developer account and a valid API key, and keep your requests to the service within certain rate limits.</p>
+
+ <div class="note">
+ <strong>Note</strong>
+ Mapzen products are available for any use, including commercial purposes. You must follow the <a href="https://mapzen.com/rights/" target="_blank">attribution requirements</a> for the data source, and also provide acknowledgment to Mapzen if you are using these Web services.
+ </div>
+
+<p>Mapzen developer account authentication is made through <a href="https://github.com" target="_blank">GitHub</a>, which is a Web site that enables people to collaborate on a project. You need a GitHub account to create a Mapzen developer account, as there is currently no other form of authentication.</p>
+
+<p>To create the Mapzen API key:</p>
+
+<ol>
+<li>If you do not have a GitHub account, <a href="https://github.com/join" target="_blank">create it</a>.
+<p>You can create any kind of account, including personal.</p></li>
+<li>Go to <a href="https://mapzen.com/developers " target="_blank">https://mapzen.com/developers</a>.
+<p>This is where you can create, delete, and manage your API keys.</p></li>
+<li>Sign in with your GitHub account.
+<p>If you are signing in for the first time, you must agree to the terms.</p></li>
+<li>Create a new Mapzen key in the dashboard.
+<p>The API key is a code that uniquely identifies your developer account without providing a password.</p></li>
+<li>Optionally, give the key a name so you can remember the purpose of the project.</li>
+</ol>
+
+<p>To use the Mapzen API key in your application, set it with the <a href="https://developer.tizen.org/dev-guide/csapi/classTizen_1_1Maps_1_1MapService.html">Tizen.Maps.MapService</a> class:</p>
+
+<pre class="prettyprint">
+var maps = new MapService("MAPZEN", "mapzen-xxxxxx");
+</pre>
+
+<h2 id="rate_limit">API Rate Limits</h2>
+
+<p>Mapzen offers a free tier for each service, subject to rate limits. Mapzen-hosted services are shared resources, so there are limitations to prevent individual users from degrading system performance for everyone. The services have maximum numbers of queries you can make within a certain period of time, and some have additional limitations to minimize computationally intensive uses. For the current free rate limits, see <a href="https://mapzen.com/pricing/" target="_blank">Mapzen pricing</a>.</p>
+
+<p>All the projects used to build the Mapzen-hosted services are open source. If you want to try Mapzen products, start with the hosted services to see if they fit your work flow needs. If you later decide that you need additional customizations or higher capacity, consider installing the open-source code used to build Mapzen services on your own servers.</p>
+
+<p>If you find a problem, need higher limits, or have enhancement suggestions for Mapzen products, contact <a href="mailto:hello@mapzen.com" target="_top">hello@mapzen.com</a>.</p>
+
+<h2 id="check">API Usage Check</h2>
+
+<p>To check your usage for a specific API key:</p>
+
+<ol>
+<li><a href="https://mapzen.com/developers" target="_blank">Sign in</a> to your developer account.</li>
+<li>Click the <strong>statistics</strong> button for the API key whose usage you want to review.</li>
+<li>View a graph of your recent usage for a certain period of time, such as the past day or month.</li>
+</ol>
+
+<p>If you exceed the rate limits, the server's response to your query contains a specific <a href="https://en.wikipedia.org/wiki/List_of_HTTP_status_codes" target="_blank">HTTP status code</a> in the header. The typical errors for exceeded limits are "403 Forbidden" and "429 Too Many Requests".</p>
+
+<p>Not all queries count towards your rate limit. Mapzen uses server caching to deliver commonly requested content as quickly as possible. Queries served from the cache are not included in the rate limit count. For example, queries can be served from the cache when the user browses a map with vector tiles in a popular region or repeatedly performs an identical geocoding search.</p>
+
+<script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
+<script type="text/javascript" src="../../scripts/showhide.js"></script>
+
+</div>
+</div>
+</div>
+
+
+<a class="top sms" href="#"><img src="../../images/btn_top.gif" alt="Go to top" /></a>
+
+<div id="footer"><p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>
+</div>
+
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-25976949-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+</script>
+</body>
+</html>
+
<p>To get credentials:</p>
<ol>
-<li>Sign in.
+<li>Go to the <a href="https://developer.here.com" target="_blank">HERE Developers</a> Web site and sign in.
<p>If you have no account, first register for the HERE Maps account.</p>
- <p>When you have an account, sign in to it.</p>
- <p><img alt="Sign in" src="../../images/here_credential_login.png" /></p>
</li>
-<li>Select a plan for using the HERE Maps services.
-
- <p>You can see available plans in the <a href="https://developer.here.com/plans" target="_blank">Plans</a> section on the top menu bar.</p>
- <p>Select the plan taking account of the number of transactions you need, and click <strong>Try for free</strong> or <strong>Sign up</strong>.</p>
- <p><img alt="Select the plan" src="../../images/here_credential_plans.png" /></p>
-</li>
-
-<li>Register a new application.
- <p>You must register a new application to create new credentials.</p>
+<li>Select a plan for using the HERE Maps services, and register a new project.
+ <p>You can select between various <a href="https://developer.here.com/plans" target="_blank">public or business plans</a>. Signing up for a plan automatically registers a new project.</p>
+ <ol type="a">
+ <li>Select the plan that meets your requirements for the number of transactions you need, and click <strong>Sign up</strong>.</li>
+ <li>Provide your contact details, and agree to the terms and conditions.
<div class="note">
<strong>Note</strong>
- Some regions or countries do not support the registration. If your contact details contain such a region or country, you cannot register a new application successfully.
- <p><img alt="Unsupported region or country" src="../../images/here_credential_register_app_evaluation.png" /></p>
+ The registration does not support some regions and countries. If your contact details contain such a region or country, you cannot register a new application.
</div>
-
- <p>The following figure shows the Evaluation plan form, which is opened when you click <strong>Try for free</strong>. Enter the required details.</p>
-
- <p><img alt="" src="../../images/here_credential_register_app.png" /></p>
+ </li>
+ </ol>
</li>
-
-<li>Confirm the new credentials.
- <p>You can check the credentials in the <a href="https://developer.here.com/applications" target="_blank">Applications</a> menu.</p>
- <p><img alt="Confirmation" src="../../images/here_credential_account_list.png" /></p>
- <p>If you click an application in the list, you can see the app ID and code related to it.</p>
- <p><img alt="Credentials" src="../../images/here_credential_app_credential.png" /></p>
+<li>Generate the credentials.
+ <p>To access the new project, select <strong>Projects</strong> in the drop-down menu next to your user name in the upper-right corner of the screen, and click the project in the project list.</p>
+ <p>To generate the credentials, click <strong>Generate App ID and App Code</strong>.</p>
</li>
<li>Use the credentials in your application.
<p>You can use the credentials in your application with the <code>maps_service_set_provider_key()</code> function.</p>
- <p>The HERE Maps services provides 2 values as credentials: app ID and app code. If the app ID is <code>XXXX</code> and the app code is <code>YYYY</code>, concatenate them with the "/" separator:</p>
+ <p>The HERE Maps services provide 2 values as credentials: app ID and app code. If the app ID is <code>XXXX</code> and the app code is <code>YYYY</code>, concatenate them with the "/" separator:</p>
<pre class="prettyprint">
maps_service_h maps = NULL;
</li>
</ol>
-</div></div></div>
<script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
<script type="text/javascript" src="../../scripts/showhide.js"></script>
+</div></div></div>
<a class="top sms" href="#"><img src="../../images/btn_top.gif" alt="Go to top" /></a>
<div id="footer">
<p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>
projects / sdk / online-doc.git / commitdiff
