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

PVID またはステーション ID によるステーション

stations/bulk このリソースを使用すると、 PVID ( PVID は、地図機能の識別に使用される一意の参照メカニズムである公開済みバージョン識別子)または PDS ID (ステーション ID )を使用して、特定のガソリンスタンドに関する動的および静的な情報を取得できます。

このリソースに対するリクエストは、 HTTP GET メソッドを使用します。

リクエスト

このコードブロック は、特定のpvidまたはpds idを持つステーションの検索リクエストを示します。


https://fuel-v2.cc.api.here.com/fuel/stations/bulk.xml
    ?id=1099721199&apiKey={YOUR_API_KEY}

リクエストパラメータ

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

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

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

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

app_code - レガシー はい

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

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

apiKey はい A 43-byte Base64 URL-safe encoded string used for the authentication of the client application. As a logged in user, you can generate it at https://here-tech.skawa.fun/projects. API Keys never expire but you can invalidate your API Keys at any time. You cannot have more than two API Keys for one app at the same time. You must include an apiKey with every request. For more information on authentication, see the Identity & Access Management Developer Guide.
id はい

必要なガソリンスタンドの PVID またはステーション ID のリスト。 回答の項目の順序は保証されていません。 要求された ID の順序と一致しない可能性があります。

存在しない PVID とステーション ID は無視されます。

リクエストあたりの ID の上限は 50 です。

content いいえ

応答の内容を制限します。

指定できる値は次のとおりです。

  • 動的 ( 動的データのみを返す )
  • すべて ( 静的データと動的データの両方を返す )

デフォルトは dynamic です

imagedimensions いいえ UI および帯域幅の要件に合わせて、brand iconイメージの特定の最大サイズを要求します

形式は、目的の幅、希望の高さ、またはその両方を指定することで、拡大縮小されたイメージの寸法を指定します

有効なエレメントは次のとおりです。

  • w\d+
  • h\d+
  • w\d + -h\d +

例 :

  • imagedimensions=W32-H32
  • imagedimensions=w300
  • 画像サイズ = H200
注 : 指定した値は、返された画像の寸法の上限として使用されます。 このソリューションでは、小さな画像はスケールアップされず、元の画像の縦横比が維持されます。

レスポンス

注 : クエリ パラメーターcontent が省略された場合 、または 'dynamic' に設定されている場合、応答には、要求された各フュエルプリセタイプエレメントの動的データのみが含まれています。

特定のステーションに対するクエリーに対する応答の詳細については、「ガソリンスタンドの応答」を参照してください。