HERE Map Tile API v2 から HERE Raster タイル API v3 に移行します

HEREラスタタイルAPI v3は、世界のすべての地域のマップタイルイメージを要求できるREST APIです。 これらのマップタイルをグリッドに結合すると、世界の完全なマップが形成されます。 これは、Here Map Tile API v2サービスの代替サービスです。

HEREラスタータイルAPI v3にアクセスするには 、HEREプラットフォームアカウントが必要です。 以前ここ で使用されていた開発者アカウント は、HEREラスタータイルAPI v3では機能しません。

変更の概要

移行を完了するには、次の一般的なアクションを実行する必要があります。

  1. HEREプラットフォームアカウントに対応するAPIキーまたはOAuthトークンを使用していることを確認します。
  2. 認証方法を調整または変更します。
  3. 要求パラメータを更新します。
  4. サポートされていないパラメータを更新します。
  5. メタデータ固有のクエリパラメータを削除します。

認証方法

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は、次の「ソース」値のみをサポートしています。basebackgroundおよび 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}

4. 画像形式

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_zonesenvironmental_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}

サポートされていないパラメータです

1. メタデータ クエリ

HERE Raster タイル API v3 は、メタデータ クエリをサポートしていません。 代わりに、次のものが

メタデータ クエリーパラメータを削除します。

  • metadata
  • output
  • callback_func
  • filter
  • mgen
  • range

」に一致する結果は 件です

    」に一致する結果はありません