リクエストボディ

このページでは、本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]
        }
    }