予約の空き情報データの構造化

パラメータの定義

Availability の定義で指定されているように、

  • party_size: このタイムスロット中に対応できる人数。1 つのレストランで同じ時間に複数の Slot を関連付けることができます。たとえば、2 人、3 人、または 4 人を予約できる場合は、それぞれに異なる party_size を指定することが可能です。
  • spots_open: この空き状況エントリで現在利用可能なスポット数
  • spots_total: 販売者がこの構成で利用できるスポットの合計数(利用できないスポットを含む)

これらの 3 つのパラメータが連携して、フロアプランのデジタル表現を構築します。party_size は、各テーブルが収容できる人数です(テーブルが収容できるサイズごとにエントリがあります)。spots_openspots_total は、その party_size に対応できるテーブルの数です。

空の間取り図の例

次のような間取りのレストランがあり、予約がアクティブでないとします。

図 1: アクティブな予約がない間取り
図 1: 有効な予約がないフロアプラン

party_sizespots_openspots_total の値は次のとおりです。

party_size spots_open spots_total
4 3 3
5 3 3
6 4 4
7 1 1
8 1 1

この販売者の 1 つの時間帯の空き状況フィードは次のようになります。

JSON

{
  "availability": [
        {
          "spots_total": 3,
          "spots_open": 3,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 4
          }
        },
        {
          "spots_total": 3,
          "spots_open": 3,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 5
          }
        },
        {
          "spots_total": 4,
          "spots_open": 4,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 6
          }
        },
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 7
          }
        },
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 8
          }
        }
      ]
}

予約が設定された間取りの例

次に、円卓の 1 つが予約されたとします。

図 2: 有効な予約が 1 件ある間取り
図 2: 1 件の有効な予約がある間取り

party_sizespots_openspots_total の値は次のようになります。

party_size spots_open spots_total
4 2 3
5 2 3
6 3 4
7 1 1
8 1 1

JSON

{
  "availability": [
        {
          "spots_total": 3,
          "spots_open": 2,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 4
          }
        },
        {
          "spots_total": 3,
          "spots_open": 2,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 5
          }
        },
        {
          "spots_total": 4,
          "spots_open": 3,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 6
          }
        },
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 7
          }
        },
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 8
          }
        }
      ]
}

結合テーブルのサポートで食事の空き状況を指定する

レストランがテーブルを組み合わせて大人数に対応する方法はたくさんあります。フィードでは、特定のサイズのパーティを受け入れることができるかどうかを正確に反映するように spots_openspots_total を指定する必要があります。以下に、結合テーブルを指定する方法の例を示します。フィードによってこの計算方法が多少異なる場合があります。ビジネス ロジックに合わせて spots_openspots_total を指定できます。

レストランがテーブルを組み合わせて大人数で利用できる場合は、spots_openspots_total を更新してこれを反映できます。

たとえば、レストランで 2 つの小さなテーブルを組み合わせて 7 ~ 10 人のグループを収容できる場合、

図 3: アクティブな予約がない間取り
図 3: 有効な予約がないフロアプラン

有効な予約がない場合は、party_sizespots_openspots_total の値は次のとおりです。

party_size spots_open spots_total
4 3 3
5 3 3
6 4 4
7 1 1
8 1 1
9 1 1
10 1 1

同じ間取りで、2 つの小さなテーブルを組み合わせて 10 人分の予約が行なわれます。

図 4: 2 つのテーブルにまたがる 1 件の有効な予約があるフロアプラン
図 4: 2 つのテーブルにまたがる 1 件のアクティブな予約を含むフロアプラン

party_sizespots_openspots_total の値は次のようになります。

party_size spots_open spots_total
4 1 3
5 1 3
6 2 4
7 1 1
8 1 1
9 0 1
10 0 1