ガソリン価格 API 開発者ガイド

ステーション数

このリソースは、指定されたエリアのガソリンスタンドの数を返します。

このリソースに対するリクエストは、 HTTP GET メソッドを使用します。 検索条件は、検索ジオメトリを含むクエリパラメータによって指定されます。

形状を検索は、次のいずれかになります。

  • Prox : 中心と半径の座標によって定義された円形の領域。
  • 廊下 : ポイントのセット(緯度 、経度 のペア)および幅として定義されたパス。
  • BBOX : 左上の緯度 と経度 、右下の緯度 と経度 で定義された正方形。

注 : フィルタリング条件は、リクエストのカウントでは考慮されません。

リクエスト

このコードブロックは、 proximity()proxを使用して検索領域を定義する検索要求を示します。


https://fuel-v2.cc.api.here.com/fuel/stations/count.xml
?prox=52.516667,13.383333,5000
-H "Authorization: Bearer {YOUR_TOKEN}"

リクエストパラメータ

この表に stations/count は、リソースでサポートされている必須およびオプションのリクエストパラメータが記載されています。

パラメーター 必須です 説明
app_id - レガシー はい

クライアント アプリケーションの認証に使用される -20 バイトの Base64 URL セーフエンコード文字列。

すべてのリクエストに認証を含める必要があります。 認証の詳細については、『 Identity & Access Management 開発者ガイド 』を参照してください。

app_code - レガシー はい

クライアント アプリケーションの認証に使用される -20 バイトの Base64 URL セーフエンコード文字列。

すべてのリクエストに認証を含める必要があります。 認証の詳細については、『 Identity & Access Management 開発者ガイド 』を参照してください。

prox proxbbox または corridor が存在する必要があります

経度とその中央の緯度 (WGS 84 に準拠 ) で定義された円形の検索エリア。面積の半径をメートル単位で表す整数で、すべてコンマで区切ります。

たとえば prox=52.516667,13.383333,5000 、 5 キロメートルの緯度 52.50 ° N と 13.55 ° E の燃料価格を検索します。この価格はベルリン市内にあります。

円の最大半径は 200 km です

bbox proxbbox または corridor が存在する必要があります

左上と右下の角にある緯度 and 経度 (WGS 84 に準拠 ) によって定義されたバウンディング ボックス 。 左上と右下のペアはセミコロンで区切り、緯度 と経度 のペアはコンマで区切ります。

たとえば、バウンディング ボックス値 bbox=52.8,11.37309;52.31,13.2の 1 つはです。

バウンディング ボックスサイズ ( 幅または高さ ) は 400 km 未満である必要があります。

corridor proxbbox、、または corridor が存在している必要があります
セミコロンで区切られたポイントのリスト ( カンマで区切られた緯度と経度 WGS 84 の対応する値のペア ) として定義
corridor=52.51666,13.38333;
52.13333,11.61666;53.56527,10.00138
されたストリップ。たとえば、ドイツからハンブルクへの移動を、マクデブルク経由で指定します。

最大廊下エリアは 5000 キロメートル2

stations/count リソースへのリクエストの合計サイズは最大 4 KB です。 corridor クエリ パラメーター は最も多くの情報を含む可能性が高い項目であるため、このパラメータには約 150 ポイントを含めることができます ( 緯度と経度のペアの精度は 5 つの小数点以下のポイント ( 例 :) 11.37309) ) 。

corridorwidth いいえ

廊下の幅 ( メートル ) 。 このパラメータは corridor 、がリクエストに含まれている場合にのみ有効になります。

最大経路幅は 20km です

デフォルト : 5000 件

レスポンス

stations/count リソースに対するクエリーへの応答の詳細について は、「ガソリンスタンド数の応答」を参照してください。