データポイントは、特定の場所、サービス、製品に対する顧客からのフィードバックを把握する上で重要な役割を果たします。データポイントには、写真、レビュー、レビューへの返信、チェックインなどがあります。これらの情報は、/api/data-points APIエンドポイントで取得し、特定の場所に関連付けたり、絞り込んだりすることができます。データポイントに関する完全なAPIドキュメントは、 こちらの「データポイント」セクションをご覧ください。

データ ポイントを場所に関連付けるプロセスは 2 つのステップから成ります。

場所のリストを取得する

データポイントの前に位置情報のリストを取得することで、すべてのデータポイントを取得してから位置情報で並べ替えやフィルタリングを行う必要がなくなり、目的の位置情報に特化されたデータポイントを取得できます。データポイントと位置情報の関連付けを行うには、APIから位置情報IDを取得する必要があります。

以下の例は、 thisに従って、現在のアカウントの所在地の完全なリストを返します。これらの所在地は、fieldMaskパラメータで定義された以下のデータとともに返されます：id、識別子、名前、番地と通り、郵便番号、市区町村。

得る https://uberall.com/api/locations?fieldMask=identifier&fieldMask&name&fieldMask=streetAndNumber&fieldMask=zip&fieldMask=city

ヘッダー ＝ {
「秘密鍵」: 「あなたの秘密鍵はこちら」
}

データポイントのリストを取得する

データポイントは一度にすべて取得することも、場所ごとに取得することもできます。パラメータとフィルターについては、 こちらをご覧ください。

すべての場所のデータポイントを取得しています

得る https://uberall.com/api/data-points

ヘッダー ＝ {
「秘密鍵」: 「あなたの秘密鍵はこちら」
}

指定された場所のデータポイントを取得する

得る https://uberall.com/api/data-points/LOCATION_ID_HERE

ヘッダー ＝ {
「秘密鍵」: 「あなたの秘密鍵はこちら」
}

データ ポイント API 応答には、場所オブジェクトのIDに直接関連付けることができるlocationId属性が含まれます。

位置とデータポイントを関連付けるには、ループを使用する必要があります。データポイントの取得方法に応じて、ループへのアプローチは異なります。

最初に場所を取得し、場所ごとにデータポイントを収集します

場所の全リストを取得した後、ループ処理でリスト全体を処理してAPI呼び出しを行い、特定の場所のすべてのデータポイントを取得します。このプロセスは、すべての場所のデータポイントが取得されるまで繰り返します。

データポイントを一括取得

場所の完全なリストとデータポイントの両方を取得したら、場所をループ処理して、場所のIDに関連付けられたデータポイントを見つけます。すべての場所にデータポイントが取得されるまで、このプロセスを繰り返します。