場所のコンテキスト
Places API と GS7 はどちらも、検索結果が関連する位置情報コンテキストの概念を共有しています。 クエリの場所のコンテキストは、通常、検索センター、円、 またはバウンディング ボックスを介して実体化されます。
地理位置は、コンマで区切ら れた 2 つの 10 進数値 (WGS 84 座標系 ) で表された両方のプロダクト内にあります。latitude,longitude
例 : 52.53044,13.41112
Places API とは異なり、 GS7 では、オプションの第 3 高度寸法、位置の不確実性 map
gps
sgps
、および投影バリアントのジオポジションはまだサポートされていません。
検索センター
ほとんどの Places API および GS7 のクエリは、検索センターを必要とします。 検索センターは、次の URL パラメーターを使用して提供されます。 at
製品 | at 形式 | 例 |
Places API | latitude,longitude[;cgen=(map|gps|sgps)][;u=\d+] | 52.5304417,13.4111201,100;cgen=gps;u=100 |
GS7. | latitude,longitude | 52.5304417,13.4111201 |
GS7 では、明示的な検索センターのみがサポートされています。 Geolocation
Places API エンドポイントでヘッダーを使用するアプリケーションは at
、関連する GS7 エンドポイントでパラメーターを同じ値に設定する必要があります。
たとえば Geolocation: 52.5304417,13.4111201
、ヘッダーのある Places API 自動候補提示エントリーポイントへのリクエストは、 URL パラメータを使用して GS7 自動候補提示サービスへのリクエストになる必要 at=52.5304417,13.4111201
があります。
影響を受ける場所 API エントリーポイント: 自動候補提示、 検索、 参照、 探索、 バイコリドー、 HERE、 その周辺
明示的なバウンディング ボックスおよび CIRCLE
位置のコンテキストは、地理的制約を介して、円または境界矩形の形式で指定できます。 Places API と GS7 の両方 in
が、 query URL パラメータを使用してこれらの制約をサポートしています。
製品 | in 円の形式 | 例 |
Places API | latitude,longitude;r=\d+(.\d+)?[;cgen=(map|gps|sgps)][;u=\d+] | 53.12,10.15,100;cgen=gps;u=100;r=10500.63 |
GS7. | circle:latitude,longitude;r=\d+ | circle:53.12,10.15;r=10501 |
半径 r
はメートル単位で指定します。
製品 | in バウンディング ボックス形式 | 例 |
Places API | west_longitude,south_latitude,east_longitude,north_latitude | 13.125,52.362,13.661,52.693 |
GS7. | bbox:west_longitude,south_latitude,east_longitude,north_latitude | bbox:13.125,52.362,13.661,52.693 |
GS7 では、明示的なバウンディングボックスのみがサポートされており、検索結果が厳密に含まれていることに注意してください。 Places API X-Map-Viewport
のヘッダ値は in=bbox
URL パラメータに移植する必要があります。 たとえば、ヘッダーを含む Places API Browse エントリーポイントに対するリクエスト X-Map-Viewport: 13.125,52.362,13.661,52.693
は、 URL パラメータを使用して GS7 サービスへのリクエストになる必要 in=bbox: 13.125,52.362,13.661,52.693
があります。 GS7 によって返された結果のアイテムは、常にその外接四角形の中に置かれます。
影響を受ける場所 API エントリーポイント: 自動候補提示、 検索、 参照、 探索、 回避
ルートと圧縮ルート
ルートは、 Places API と GS7 製品の両方で、地理的位置のシーケンスとメートル単位の幅の廊下として表されます。 ルート沿いの検索については、 GS7 開発者ガイドで説明されています。
Places API は圧縮形式と非圧縮形式の両方をサポートしていますが、 GS7 は圧縮形式のみをカバーして URL の長さを短くすることを選択しました。
API および GS7 で使用されている胸骨圧迫は非常に似ている。 GS7 では 、「 HERE flexible-polyline 」 エンコーディングを使用 しています。このエンコーディングは、「 HERE ポリラインエンコーディング」自体の総称化であり、「エンコードされたポリラインアルゴリズム形式」のバリアントです。 両方の製品で、圧縮された値がスキーマ:に準拠するようにし [a-zA-Z0-9_-]+(;w=\d+)?[a-zA-Z0-9._-]+
ます。
同じ点のリストの場合、 HERE Flexible Polyline は 3 番目の寸法のない HERE ポリラインと等しく、ヘッダーの前に付加 BF
されます。 たとえば、両方のポイント間の幅 1000 メートルの非常に単純なルート 52.5199356,13.3866272
は 52.5100899,13.2816896
、次のように圧縮されます。
-
05xgKuy2xCx9B7vU;w=1000
Places API compressedRoute
パラメータの場合 -
BF05xgKuy2xCx9B7vU;w=1000
GS7 route
パラメータの場合
GS7 では現在、ルートに沿った検索の緊急度はサポートされていません。 緊急度は常にです 1.0
。 可変幅CW
(,,) も HW
DW
現在サポートされていません。 GS7 の廊下の幅は、 w
サブパラメータを通して固定されています ( デフォルトは 1000m) 。
開発者は 、 HERE ポリラインコンバータ パッケージを確認して、文字列を HERE ポリライン から HERE フレキシブルポリラインに変換できます。
影響を受ける場所 API エントリーポイント: 自動候補提示、 検索、 参照、 By Corridor