HERE Map Tile API v2 から HERE Raster タイル API v3 に移行します
HEREラスタタイルAPI v3は、世界のすべての地域のマップタイルイメージを要求できるREST APIです。 これらのマップタイルをグリッドに結合すると、世界の完全なマップが形成されます。 これは、Here Map Tile API v2サービスの代替サービスです。
変更の概要
移行を完了するには、次の一般的なアクションを実行する必要があります。
- HEREプラットフォームアカウントに対応するAPIキーまたはOAuthトークンを使用していることを確認します。
- 認証方法を調整または変更します。
- 要求パラメータを更新します。
- サポートされていないパラメータを更新します。
- メタデータ固有のクエリパラメータを削除します。
認証方法
HERE Raster タイル API v3 は、 API キー および OAuth トークン の認証方式をサポートしています。 詳細 については、『 HERE ラスター タイル API v3 リファレンスドキュメント』の「認証」セクションを参照してください。
リクエストパラメータを更新します
HERE ラスター タイル API v3 の定義が HERE Map Tile API v2 の定義と異なります。 詳細なドキュメントについては、 HERE ラスター タイル API v3 リファレンスドキュメントを参照してください。
HERE Map Tile API v2 から HERE Raster タイル API v3 に移行するには、以下の更新されたリクエストパラメータを確認してください。
1. 地図のバージョン
HERE Raster タイル API v3 では 、 HERE Map Tile API v2 の必須パラメータmap id
と比較して、マップのバージョンがオプションのパラメータmv
として指定されます。
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/540f1ab0fd/normal.day/11/1100/671/256/png8?apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/png8?mv=in306jp113&apiKey={API_KEY} |
上の例の URL には、利用できなくなった地図バージョンが含まれています。
/info
リソースに問い合わせて、 HERE Raster タイル API v3 で使用可能なマップのバージョンを確認します。
mv
HERE Raster タイル API v3 のクエリでパラメータが指定されていない場合、常に最新のマップがタイル のレンダリングに使用されます。 HERE Map Tile API v2 で map id
は、をに設定することで同じ動作が実現 newest
されます。
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/11/1100/671/256/png8?apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/png8?apiKey={API_KEY} |
2. コンテンツと外観 ( ドメイン / スキーム / スタイル )
HERE Map Tile API v2 では、サービスドメイン、 scheme
リソース、 style
およびパラメータを使用して、レンダリングされたマップ タイル の内容と外観が定義されます。 HERE Raster タイル API v3 でも同じことを実現 style
するには、パラメーターを使用します。
HERE Raster タイル API v3 では、 style
は既定値を持つオプションのパラメータ explore.day
です。
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.night/11/1100/671/256/png8?style=default&apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/png8?style=explore.night&apiKey={API_KEY} |
HERE Map Tile API v2 で衛星タイル イメージを表示 aerial
するには、ドメインが使用されます。 HERE Raster タイル API v3 で style=satellite.day
は、パラメーターを指定すると衛星タイル イメージがレンダリングされます。
例
HERE Map Tile API v2 |
https://1.aerial.maps.ls.hereapi.com/maptile/2.1/maptile/newest/satellite.day/11/1100/671/256/png8?apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/png8?style=satellite.day&apiKey={API_KEY} |
/info
リソースに問い合わせて利用可能な HERE ラスター タイル API v3 スタイルを確認し、それに応じてクエリを指定します。
3. リソース
HERE Map Tile API v2 では、タイル コンテンツはを使用して定義 resource
されます。
ここでは、ラスタタイルAPI v3は、次の「ソース」値のみをサポートしています。base
、 background
および blank
label
。
リソース名の移行
説明 | HERE Map Tile API v2 | HERE ラスター タイル API v3 |
管理用ラベル | alabeltile. | サポート対象外です |
ベース マップ タイル | 基礎 | 背景 |
ベースラインマップ タイル | ワインタイル | サポート対象外です |
ラベルタイル | ラベルタイル | ラベル |
Line タイル (回線設定) | 収益性 | サポート対象外です |
線とラベルタイル | lltile | サポート対象外です |
マップ タイル | マップタイル | ベース |
Street タイル | 路面電車が利用できる | サポート対象外です |
トラックタイル | トラックタイル | パラメーターを含むベース features=vehicle_restrictions:active_and_inactive |
トラックのみのタイル | トラックのみ | パラメータが空白です features=vehicle_restrictions:active_and_inactive |
追加の ベース マップ タイル | xbasetile | サポート対象外です |
トラック公共交通機関なしタイル | trucknopttile | パラメーターを含むベース features=vehicle_restrictions:active_and_inactive |
公共交通機関なしの地図タイル | 地図更新 | ベース |
/info
リソースに問い合わせて、利用可能な HERE ラスター タイル API v3 リソースを確認します。
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/trucktile/newest/normal.day/11/1100/671/256/png8?apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/png8?features=vehicle_restrictions:active_and_inactive&style=explore.day&apiKey={API_KEY} |
HERE Raster タイル API v3 は、 HERE Map Tile API v2 と同じイメージ形式をサポートしています。 値の名前が異なります。
HERE Map Tile API v2 | HERE ラスター タイル API v3 |
png | png |
png8 | png8 |
jpg | jpeg |
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/11/1100/671/256/jpg?apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/jpeg?apiKey={API_KEY} |
5. サイズ
HERE Raster タイル API v3 では 、 HERE Map Tile API v2 の必須パラメータsize
ではなく、マップ タイル イメージサイズがオプションのパラメータsize
として指定されます。
イメージサイズの値の移行
HERE Map Tile API v2 | HERE ラスター タイル API v3 |
128 | サポートされていません 256 。または 512 を使用してください |
256 | 256 デフォルト値 |
512 | 512 |
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/11/1100/671/512/png8?apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/png8?size=512&apiKey={API_KEY} |
6. 言語
HERE Raster タイル API v3 では 、 HERE Map Tile API v2 のlang
パラメーターおよびlang2
パラメーターと比較して、パラメーターlg
およびlg2
を使用して言語が指定されます。
言語パラメータ名の移行
説明 | HERE Map Tile API v2 | HERE ラスター タイル API v3 |
第一言語 | lg | lang |
第 2 言語 - 二重ラベル | lg2 | lang2 |
言語パラメータ値の移行
HERE Map Tile API v2 で は、lg
およびlg2
のパラメータの値は MARC
3 文字の言語コードで記述されています。
HERE Raster タイル API v3 で lang
lang2
は、 BCP47
言語コードは ISO 639-1
2 文字の言語コード、およびオプション で ISO 15924
4 文字のスクリプトコードに制限されています。
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/11/1438/914/256/png8?lg=HIN&lg2=ENG&apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1438/914/png8?lang=hi&lang2=en&apiKey={API_KEY} |
/languages
HERE Raster タイル API v3 のリソースに問い合わせて利用可能な言語を確認し、それに応じて HERE Map Tile API v2 クエリを更新します。
7. ピクセル / インチ (PPI)
HERE Raster タイル API v3 は ppi
、 HERE Map Tile API v2 とは異なる値をサポートしています。
PPI の価値の移行
HERE Map Tile API v2 | HERE ラスター タイル API v3 |
72 | 100 |
250 | 400 |
320 | 400 |
500 | 400 |
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/11/1100/671/256/png8?&ppi=500&apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/png8?ppi=400&apiKey={API_KEY} |
8. 地政学的見解
/meta/pviews
HERE Map Tile API v2 でサポートされている地政学的なビューを確認するには、リソースをクエリします。
/politicalViews
リソースに問い合わせて、 HERE Raster タイル API v3 でサポートされている地政学的なビューを確認します。 サポートされていない地政学的ビューが使用されている場合は、 HERE Map Tile API v2 のクエリを更新します。
地政学的ビューのパラメーター値の移行
HERE Map Tile API v2 で pview
は、パラメーターは ISO 3166-1
alpha-3 国コードを使用しています。
HERE Raster タイル API v3 で pview
は、パラメーターは ISO 3166-1
alpha-2 国コードを使用しています。
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/11/1100/671/256/png8?&pview=ARG&apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/11/1100/671/png8?pview=AR&apiKey={API_KEY} |
9. POI
HERE Map Tile API v2 では、 POI は pois
パラメータを使用して処理されます。 は pois
、 POI カテゴリのマスクを指定します。
HERE ラスター タイル API v3 では、この pois
機能を使用して POI を処理できます。 この機能では、「すべて」または「無効」をそれぞれ設定することで、すべての POI を有効または無効にできます。
/features
リソースを照会して、 HERE ラスター タイル API v3 スタイルに対応する使用可能な機能を確認します。
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/17/70399/42969/256/png8?pois=0&apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/17/70399/42969/png8?features=pois:disabled&apiKey={API_KEY} |
10. 混雑ゾーンと環境ゾーン
HERE Map Tile API v2 では、輻輳および環境ゾーンの表示は congestion
パラメータで処理されます。
HERE Raster タイル API v3 では、輻輳ゾーンと環境ゾーンは congestion_zones
と environmental_zones
の機能とは独立して処理されます。
例
HERE Map Tile API v2 |
https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/9/272/177/256/png8?congestion&apiKey={API_KEY} |
HERE ラスター タイル API v3 |
https://maps.hereapi.com/v3/base/mc/9/272/177/png8?features=environmental_zones:all,congestion_zones:all&apiKey={API_KEY} |
サポートされていないパラメータです
HERE Raster タイル API v3 は、メタデータ クエリをサポートしていません。 代わりに、次のものが
メタデータ クエリーパラメータを削除します。
metadata
output
callback_func
filter
mgen
range