リクエストボディ
このページでは、本APIに送信するリクエストボディの構成について説明します。ユーザーの年齢や性別といった基本属性に加え、 旅行に関する条件(地域、同行者、滞在時間、日時)および好みのカテゴリ・タグなどをJSON形式で指定します。 これらの情報は、観光地提案モデルがユーザーに最適なスポットを選定するための判断材料として使用されます。正確かつ十分な情報を入力することで、より精度の高い提案が可能になります。
送信するユーザーデータ
| Key | 説明(value) | 備考 |
|---|---|---|
| age | ユーザーの年齢 | |
| gender | ユーザーの性別 | |
| discovery_status | 認知度・ステージ分類 1: 定番。多くの人に知られ、観光客が多い。 2: 発展中。徐々に知名度が上がってきている。 3: 知る人ぞ知る観光地。SNSなどで注目され始めている。 4: 地元民には知られているが、外部には無名。 5: 最近できた、もしくは登録されたばかりのスポット。 |
必須 |
| group_size | 同行者の種類 1 一人 2 友人 3 カップル 4 家族 5 グループ 6 シニア |
必須 |
| region | 行きたい都道府県 (ISO 3166-2:JP 都道府県コードに準拠) |
必須 |
| stay_duration | 滞在時間 1 30分 2 30分~1時間 3 2~3時間 4 半日 5 一日 6 一日以上 |
必須 |
| stay_datetime | 旅行(訪問)日時 | |
| categories | 好みのカテゴリー(3つ) | 必須 |
| tags | 好みのタグ(6つ) | 必須 |
categories,tagsについて
カテゴリー・タグ一覧を見る
ユーザーの嗜好をもとに観光地をマッチングするため、以下のルールでカテゴリーとタグを指定する必要があります。
ユーザーは 3つの異なるカテゴリー(categories) を選択
各カテゴリーに対して、2つの対応タグ(tags) を指定
合計:3カテゴリー × 各2タグ = 6タグ
テストデーター
パターン1:一人旅 × 現代カルチャー × 食べ歩き・映えスポット狙い(20代女性)
{
"basic_info": {
"age": 24,
"gender": "female"
},
"user_dynamic_info": {
"discovery_status": 3,
"group_size": 1,
"region": "JP-40",
"stay_duration": 3,
"stay_datetime": "2025-09-10"
},
"user_static_info": {
"categories": [3, 4, 8],
"tags": [304, 305, 402, 404, 801, 805]
}
}
パターン2:家族旅行 × 文化・歴史 × 子どもと学べる観光(40代男性)
{
"basic_info": {
"age": 45,
"gender": "male"
},
"user_dynamic_info": {
"discovery_status": 1,
"group_size": 4,
"region": "JP-40",
"stay_duration": 5,
"stay_datetime": "2025-11-03"
},
"user_static_info": {
"categories": [2, 5, 6],
"tags": [201, 208, 501, 503, 602, 603]
}
}
パターン3:グループ旅行 × アクティブ系 × 1日以上アウトドア(大学生グループ)
{
"basic_info": {
"age": 21,
"gender": "male"
},
"user_dynamic_info": {
"discovery_status": 2,
"group_size": 5,
"region": "JP-40",
"stay_duration": 6,
"stay_datetime": "2025-08-20"
},
"user_static_info": {
"categories": [1, 6, 8],
"tags": [103, 116, 601, 604, 804, 806]
}
}