はじめに
HERE platform を利用している HERE Location Services の新しいセットを発表し、発表できることを大変嬉しく思います。このセットには、 developer.here.com の Developer ポータルから簡単にアクセスできます。 これらの新たにリリースされたバージョンの HERE Location Services は、ユニファイド API フレームワークを提供すると同時に、 HERE platform を活用することで、あらゆる顧客がロケーションサービスの幅広いサービスを簡単かつ効率的に導入できるようにします。 位置情報サービスをご利用のお客様は、再設計および調整された一連の API 、すべての位置情報サービスとの互換性を備えた合理化されたアーキテクチャのメリットを享受できます。これらの API は、同じ HERE Map Data 、認証および承認方法、および API 仕様を共有しているためです。 また、新たにリリースされた HERE Location Services では、地図更新頻度の向上と、本日 HERE platform を通じて実現された新しい地域(最近統合された日本の高詳細地図など)の迅速な利用を通じて、地図の更新内容を活用しています。
新しいサービスフレームワークが導入されたことで、新たにリリースされた HERE Location Services でのみ利用可能になる新しい機能を提供することも可能になりました。
HERE Location Services の最新バージョンにアクセスすると、現在のすべてのお客様がこれらの新機能を利用できます。 すでにトークンまたは API キー 認証を使用している場合は、アクセス資格情報に関する変更は必要ありません。 それでも app_id と app_code を使用している場合 は、 https://developer.here.com/documentation/identity-access-management にあるドキュメントを参照してください。ここで、新しい資格情報の作成方法と使用方法についての情報を参照できます。
ご登録ありがとうございました。 すべてのお客様に、新しいサービスの詳細を確認して評価してもらい、提供する新機能について理解してもらうことをお勧めします。
等値線 (Isoline) ルーティングサービス v7 から 等値線 (Isoline) ルーティングサービス v8 に移行します
ここでは、今後数か月の間に Routing v7 サービスの廃止が予定されており、サービスはメンテナンスモードになっています。 このガイドでは、 等値線 (Isoline) ルーティング v7 サービスのユーザーが、アプリケーションで 等値線 (Isoline) ルーティング V8 サービスを使用するように切り替える方法について説明します。 詳細については、「 等値線 (Isoline) ルーティング V8 開発者ガイド および API リファレンス 」を参照してください。
準備
移行を完了するには、次の一般的なアクションを実行する必要があります。
- 認証方法の変更 ( 該当する場合 )
- リクエストパラメータを更新します
- 新しい出力形式の更新処理
注
概念の変更により、サポートされなくなった入力および出力パラメーターがあります。 これらについては、このガイドで詳しく説明します。
Calculate 等値線 (Isoline) リクエストの移行
このセクションでは、 等値線 (Isoline) ルーティング V8 への移行に必要な重要な変更点について説明します。
リクエスト
パラメータが追加されました
移行にパラメーターが追加されていません。
パラメータが変更されました
基本 URL 、バージョン、リソース
パラメーター | 等値線 (Isoline) の計算 (v7) | 等値線 (Isoline) ルーティング( V8 ) |
基本 URL | 文字列 , https://isoline.route.ls.hereapi.com/routing | 文字列 , https://isoline.router.hereapi.com |
バージョン | 文字列 , /7.2 | 文字列 , /v8 |
リソース | 文字列 , /calculateisoline.json | 文字列 , isolines |
認証
| 等値線 (Isoline) (v7) | 等値線 (Isoline) ルーティング( V8 ) |
形式 | 文字列 , app_id/app_code | apiKey 要求ヘッダーのパラメータまたは OAuth bearer トークン。 |
現在使用可能な認証方法の詳細について は、『 Identity & Access Management 開発者ガイド』を参照してください。
利用可能な使用プランおよび制限の詳細について は、「価格設定とプラン」を参照してください。
requestId
クエリ パラメーターが HTTP ヘッダーに置き換え X-Request-ID
られます。
| requestId (v7) | X-Request-ID ( V8 ) |
形式 | 文字列 | HTTP ヘッダーの文字列 |
start
対 origin
移行によって start
、パラメーターがに置き換え origin
られます。 単純な座標も引き続き使用できます。追加の経由地一致機能の予想される形式については、 API 仕様を確認してください。
例について は、「距離ベースの 等値線 (Isoline) ルーティングおよび経由地 の計算」を参照してください。
| start (v7) | origin ( V8 ) |
形式 | 文字列 , {lat, long} | waypoint オブジェクト。 |
destination
移行によって destination
、パラメータのデータ型が変更されます。 単純な座標も引き続き使用できます。追加の経由地一致機能の予想される形式については、 API 仕様を確認してください。
| destination (v7) | destination ( V8 ) |
形式 | 文字列 , {lat, long} | waypoint オブジェクト。 |
departure
対 departureTime
| departure (v7) | departureTime ( V8 ) |
形式 | xs:dateTime | RFC 3339 、 ()YYYY-mm-ddTHH:MM:SS(.NNN)(Z|+/-AA:BB) 、または文字列で any は、時間依存属性 ( トラフィックなど ) の使用はスキップされます |
arrival
対 arrivalTime
| arrival (v7) | arrivalTime ( V8 ) |
形式 | xs:dateTime | RFC 3339 、 ()YYYY-mm-ddTHH:MM:SS(.NNN)(Z|+/-AA:BB) 、または文字列で any は、時間依存属性 ( トラフィックなど ) の使用はスキップされます |
range
および rangeType
vs range
オブジェクト
range
と rangeType
が、 2 つのフィールドを持つ range
オブジェクト、 range[type]
および range[values]
に置き換えられます。
type
| rangeType (v7) | range[type] ( V8 ) |
形式 | 文字列、使用できる値は distance 、、 time 、 consumption | 文字列。使用できる値は distance 、、 time 、consumption です。 |
values
| range (v7) | range[values] ( V8 ) |
形式 | 文字列。単位をベースにしたコンマ区切りのリストです rangeType | 文字列。単位をベースにしたコンマ区切りのリストです range[type] |
mode
VS routingMode
transportMode
、およびその他のパラメータ
移行では、複合 mode
(string, Type +[TransportModes]+[TrafficMode] +[Feature] ) フィールドが複数の独立したフィールドに置き換えられます。
Type
| Type (v7) | routingMode ( V8 ) |
形式 | 文字列、使用できる値は fastest 、、 shortest 、 balanced | 文字列。使用できる値は fast およびです short |
TransportMode
| TransportModes (v7) | transportMode ( V8 ) |
形式 | 文字列、サポートされているタイプは car 、、 pedestrian 、 truck | 文字列、サポートされているタイプは car 、およびです pedestrian truck |
TrafficMode
| TrafficMode (v7) | 削除済み( V8 ) |
形式 | 文字列、サポートされているタイプは enabled 、、 disabled 、 default | departureTime=any または arrivalTime=any が使用されない限り、トラフィックは常にイネーブルになります。 |
Feature
| Feature (v7) | Avoid[feature] ( V8 ) |
形式 | 文字列。 RouteFeatureType: RouteFeatureWeightType | 回避するルートフィーチャーのカンマ区切りのリストを表す文字列。 サポートされている機能のリストについては、 API の仕様を参照してください。 |
パラメーター | 料金所 :-2 | [features] = tollRoad を避けてください |
パラメーター | 高速道路 :-2 | [features] = controlledAccessHighway を回避します |
パラメーター | ボートフェリー : 2番 | [features] = フェリーを避けてください |
パラメーター | 鉄道フェリー :-2 番 | [features] = carShuttleTrain を避けます |
パラメーター | トンネル :-2 | [features] = トンネルを避けてください |
パラメーター | 道案内 : -2 番 | [features] = dirtRoad を避けてください |
パラメーター | 回避理由 | Avoid [features] = difficultTurns (TransportMode = TRACK) の場合のみ有効 ) |
quality
対 optimizeFor
quality
パラメーターの名前がに変更 optimizeFor
されます。 このパラメータでは、 等値線 (Isoline) 計算の最適化方法を指定します。値は次のとおりです。
quality (v7) | optimizeFor ( V8 ) |
品質 = 1 | optimizeFor= 品質 |
品質 = 2 | optimizeFor=balanced です |
品質 = 3 | optimizeFor= パフォーマンス |
最大点
| maxPoints (v7) | shape[maxPoints] ( V8 ) |
形式 | 整数、最大ポイント数 =100 | 整数、シェイプ [maxPoints] = 100 |
解決策
移行によって、解決パラメーターの単位が変更され、精度が 3 倍になりました。 v7 の動作を一致させるには、 v7 の入力値に 3 を掛けます。|(v7) resolution
| shape[maxResolution]
(v8) | ||::------- |: --------------------- |--------------------- || 形式 | 整数、解像度 =100| 整数、シェイプ [maxResolution]=100|
注
等値線 (Isoline) maxPoints
の品質と正確性は、値が小さくなると低下します。 したがって、 V8 では、値が最大 30 ポイント未満に制限されています。 maxPoints
最適な等線量線を得るには、 100 より大きい値を使用することをお勧めします。
EV パラメータ
| customConsumptionDetails (v7) | ev[] ( V8 ) |
形式 | customConsumptionDetails | ev[] パラメータ設定を使用します。 詳細については 、『開発者ガイド』を参照してください。 |
トラック固有のパラメータ
ルーティング V8 で truck
は、パラメータは廃止されました。 vehicle
代わりにパラメーターを使用してください。 同じリクエストでは、truck
パラメータとvehicle
パラメータを使用しないでください。
V7 Parameter | V8 Parameter |
axleCount | 車両を使用 [axleCount] |
造船、 HazardousGoods | 車両の使用 [ 造船所 ] |
limitedWeight | 車両を使用してください [grossWeight] 。 キログラム単位で値を入力してください |
無積載重量 | 車両を使用 [weightPerAxle] |
高さ / 幅 / 長さ | 車両 [ 高さ ] 、車両 [ 幅 ] 、車両 [ 長さ ] を使用してください。 値をセンチメートル単位で指定します。 |
tunnelCategory | 車両を使用 [tunnelCategory] |
トラックタイプ | 車両を使用 [ タイプ ] |
TrailersCount | 車両の使用 [ 追跡件数 ] |
パラメータが削除されました
パラメーター | V7 の動作 | V8 の動作 |
singleComponent | に設定すると true 、 等値線 (Isoline) サービスは、フェリーで区切られた各島に個別のポリゴンを作成するのではなく、常に単一のポリゴンを返します。 デフォルト値はです false 。 | 分離されたリージョン / アイランドは、常に複数のポリゴンとして返されます。 |
resolution | 等値線 (Isoline) ポリゴンに必要な詳細レベルを指定できます。 単位はメートル / ピクセルです。 解決率が高いと、サービスからの応答時間が長くなる可能性があります。 | 現在の動作は、 v7.2 でパラメータを指定しないことと同じです |
speedProfile | 削除されました 将来的には、実際の車速を調整するためにすべての車両パラメータを考慮する必要があります。 |
consumptionModel | このサービスでは、車両固有のパラメータを指定できます。このパラメータを使用して、所定のルートでの車両のエネルギー消費量を計算できます。 |
この移行で Format
は、パラメータ (v7) が削除されます。 応答は常に JSON 形式( V8 )で返されます。 XML はサポートされなくなりました。
レスポンス
ここでは、応答の変更点について説明します。
応答の構造
返されたアイソセンタのジオコード化された座標は 、 Flexible ポリラインとしてエンコードされます。 デコーダーは、レポジトリで複数の一般的なプログラミング言語で使用できます。
パラメータが追加されました
応答に次のパラメータが追加されました。
-
notices
: 要求された 等値線 (Isoline) の生成中に発生した可能性のある問題について説明してください。
パラメータが変更されました
V7 の動作 | V8 の動作 |
center および start /destination | ユーザーが origin または destination リクエストパラメーターを提供したかどうかに応じて、 departure または arrival に置き換えられます。 これらのパラメーターは、出発または到着の Time および Place を記述するオブジェクトです。 |
isoline | ユーザー isolines が指定した範囲ごとに 1 つずつ、要素の配列であるに置き換えられます。 |
range | isolines 配列内の要素に使用される範囲の type AND value を定義する range オブジェクトに置き換えられました。 |
component | 指定 polygons したの 等値線 (Isoline) を定義するポリゴンのリストであるに置き換え range られました。 各 polygon には、 等値線 (Isoline) の外側の境界を定義する地理座標のリストである outer エレメントがあります。 ジオコード化された座標は Flexible ポリラインとしてエンコードされます。 |
Connection | 接続で polygons は、配列インデックスによって配列の接続されている要素が fromPolygonIndex AND で参照されるようになり toPolygonIndex ました。 接続のシェイプは、によって定義 shape されます。 一連のジオコード化さ れた位置で、 Flexible ポリラインとしてもエンコードされます。 |