LocalFeed

位置情報ベースのフィードとタイムラインを提供するサービスです。

エンドポイント

サービス: bazbii.feed.v1.LocalFeed
パッケージ: bazbii.feed.v1
定義ファイル: packages/proto/bazbii/feed/v1/local_feed.proto

gRPCサービス定義

service LocalFeed {
  rpc List(ListRequest) returns (ListResponse);
}

Methods

List

指定した位置（H3セル）周辺の投稿を取得します。位置情報ベースのフィード表示やタイムライン表示に使用されます。

注意: 現在、ローカルフィードとタイムラインの両方でこのメソッドを使用しています。将来的にはタイムライン用の専用メソッドが追加される予定です。

リクエスト

message ListRequest {
  string h3_hex = 1;                    // 中心となるH3セル（16進数文字列、必須）
  bazbii.types.v1.Paging paging = 10;   // ページネーション
}

message Paging {
  string cursor = 1; // カーソル（次ページ取得用、オプション）
  int32 limit = 2;   // 取得件数（デフォルト: 20、最大: 100）
}

レスポンス

message ListResponse {
  repeated bazbii.types.v1.Post items = 1; // 投稿リスト
  string next_cursor = 2;                  // 次ページのカーソル
}

message Post {
  string id = 1;
  string actor_id = 2;
  ActorKind actor_kind = 3;
  string text = 4;
  google.protobuf.Timestamp created_at = 5;
  optional PartnerMeta partner = 11;
}

enum ActorKind {
  ACTOR_KIND_UNSPECIFIED = 0;
  SYSTEM = 1;
  USER = 2;
  PARTNER = 3;
  BOT = 100;
}

パラメータ

• h3_hex: 中心となるH3セルID（16進数文字列、必須）
• paging.cursor: ページネーション用カーソル（オプション、次ページ取得時に使用）
• paging.limit: 取得件数（デフォルト: 20、最大: 100）