利用開始

HEREプラットフォームを設定して最初のリクエストを処理することによって、HERE Raster Tile APIの操作を実際に体験してみましょう。

📘
注
HEREアカウントの設定、プロジェクトの作成、サービスのリンク、アプリの登録、認証の詳細については、「Identity and Access Management Guideのガイド」を参照してください。

HEREアカウントを取得する

組織管理者からの招待状を通じて、または無料で利用を開始して、HEREプラットフォームへのアクセスを入手します。

会社がすでにHEREプラットフォーム組織を設立している場合は、組織への参加に招待できる管理者に連絡してください。
会社がまだHEREプラットフォーム組織を設立していない場合は、無料で利用を開始できます。詳細については、「HEREプラットフォームの価格設定」を参照してください。

アプリを登録して、HERE プラットフォームへのリクエストを認証するための一意の API キーを作成します。

[ランチャー]ペインで[アクセスマネージャー]を選択します。
[アクセスマネージャー] ページで [アプリ] タブをクリックします。
[アプリ] タブで [新しいアプリを登録] をクリックします。
[新しいアプリを登録] ウィンドウで新しいアプリの詳細を入力します。
1. [名前] フィールドにアプリ名を入力します。
2. [プロジェクトへのデフォルトアクセス] フィールドで新しいアプリの範囲を定義します。
  - アプリがすべての位置情報サービス API にアクセスできるようにするには、[プロジェクトなし] を選択します。
  - 特定のプロジェクトに含まれる位置情報サービス API のみにアクセスするようにアプリケーションを制限するには、リストからそのプロジェクトを選択します。
3. [登録]をクリックします。HEREプラットフォームで、一意のアプリIDを持つ新しいアプリが作成されます。
アプリページで最大 2 つの API キーを生成します。
1. [資格情報] タブで [API キー] を選択し、[API キーを作成] をクリックします。HERE プラットフォームには作成した API キーと enabled ステータスが表示されます。
2. 任意：追加の API キーを追加するには、[API キーを作成]をクリックします。

次の図は、API キーの生成の概要を視覚的に示しています。
アプリの API キーの生成

ラスターマップタイルをリクエストします。ラスターマップタイルは地図の特定領域の事前レンダリングされた画像です。

タイルの中心となる任意の位置を選択し、その位置情報 latitude 座標と longitude 座標をメモします。
latitude と longitude を column と row のラスタータイルグリッド座標に変換します。詳細については、メルカトル図法を参照してください。
選択した位置の座標を中心とするタイルを入手するための GET リクエストを構築します。

ケープタウンを中心とするラスタータイルについて、次のリクエスト例を考えてみましょう。
```
curl "https://maps.hereapi.com/v3/base/mc/9/282/307/png?apiKey={API_KEY}"
```
説明：
- base はラスタータイルで使用可能なレイヤーです
- 9 はズームレベルです
- 282 は column グリッド座標です
- 307 は row グリッド座標です
詳細については、「APIリファレンス」を参照してください。

📘
注
サンプルリクエストでは、認証に API キーを使用します。OAuthトークン認証の詳細については、「IDとアクセス管理の開発者ガイド」を参照してください。
リクエストを送信します。たとえば、Postman ツールを使用できます。

結果：コード 200 を使用したサーバーのレスポンスに成功すると、次の例に示すように、リクエストした地図グリッド座標のレンダリング済みラスタータイル画像が含まれます。