ボラタイル レイヤーからデータを取得します

最新の公開データは ボラタイル レイヤーからのみ取得できます。

ボラタイル レイヤーからデータを取得するには、次の手順に従います。

1. OlpClientSettings オブジェクトを作成します。

   手順については、「プラットフォームクライアント設定を作成する」を参照してください。

2. VolatileLayerClient ステップ 1 で設定したレイヤー、レイヤー ID 、およびプラットフォームクライアントを含むカタログの HERE リソースネーム （ HERE リソースネーム ）を使用してオブジェクトを作成します。

   olp::dataservice::read::VolatileLayerClient layer_client(
   olp::client::HRN(kCatalogHRN), layer_id, client_settings);
   

3. DataRequest パーティション ID と次のいずれかのフェッチオプションを使用してオブジェクトを作成します。

   • ( デフォルト ) 要求されたリソースがキャッシュに見つからない場合にネットワークを照会するに OnlineIfNotFoundは、を使用します。
   • キャッシュの検索をスキップして、ただちにネットワークにクエリーを送信するに OnlineOnlyは、を使用します。
   • キャッシュの検索に失敗した場合にただちに戻るに CacheOnlyは、を使用します。
   • 要求されたキャッシュ済みリソースが見つかった場合にそのリソースを戻し、バックグラウンドでキャッシュを更新するに CacheWithUpdateは、を使用します。

   auto request = olp::dataservice::read::DataRequest()
                      .WithPartitionId(partition_id)
                      .WithBillingTag("MyBillingTag")
                      .WithFetchOption(FetchOptions::OnlineIfNotFound);
   

4. GetRequestDataRequest パラメーターを使用してメソッドを呼び出します。

   auto future = layer_client.GetData(request);
   

5. DataResponse 未来を待っていてください。

   olp::dataservice::read::DataResponse data_response =
   future.GetFuture().get();
   

DataResponse このオブジェクトは、完了した操作の詳細を保持し、操作の成功および結果のデータへのアクセスを判断するために使用されます。

• IsSuccessful() –操作が成功した場合は、を返し trueます。 それ以外の場合は、を返します false
• GetResult()–操作が成功すると、次の結果データが返されます。 olp::dataservice::read::DataResult
• GetError() – olp::client::ApiError オブジェクトのエラーの結果としてエラー情報が含まれます。

if (data_response.IsSuccessful()) {
    auto response_result = data_response.GetResult();
    // Handle success
} else {
    auto api_error = data_response.GetError();
    // Handle fail
}