デベロッパーネットワークトップ > テキスト解析 > 自然言語理解
テキスト解析

自然言語理解

自然言語理解Web APIを利用してアプリケーションを開発

Yahoo!音声アシストでも使われている自然言語理解Web APIを利用して、アプリケーションを作成できます。

リクエストURL
JSON
https://jlp.yahooapis.jp/NLUService/V1/analyze

日本語文を解析し、情報の抽出を行う機能を提供します。

リクエストパラメータ

仕様

「RESTリクエストの構築（GET）」および、「RESTリクエストの構築（POST）」をご参照ください。

パラメータ 値 説明
appid（必須） string アプリケーションID。詳細はこちらをご覧ください。
intext（必須） string 解析対象のテキストです。

過去のリクエスト履歴を引き継ぐ場合

レスポンスフィールドに含まれるパラメータの末尾に_prev{N}をつけ、そのままリクエストパラメータとしてすべて含めてください。リクエスト履歴は過去3回分まで引き継がれます。 詳細はサンプルコードを参考にしてください。

パラメータ 値 例
param_place_prev1 string 新宿
...

サンプルリクエストURL

https://jlp.yahooapis.jp/NLUService/V1/analyze?appid=<あなたのアプリケーションID>&intext=%E6%96%B0%E5%AE%BF%E3%81%AE%E5%A4%A9%E6%B0%97

サンプルコード

自然言語理解を使用したサンプルコードです。



レスポンスフィールド

詳細はこちらをご覧ください。

共通フィールド

フィールド 例 説明
result 解析結果のすべてを含みます。
result/intext 新宿の天気 リクエストの入力テキスト。
result/method WEATHER 応答ドメインの種類。TRANSIT（乗り換え）、WEATHER（天気）、SAY（雑談）など。
result/status 200 応答ステータスの種類。
  • 200 – 正常。言語理解できて応答が返せる場合。
  • 201 – 正常。言語理解できず応答が返せない場合。
  • 400 – 異常、エラー。

    • 特定のレスポンスのみに存在するフィールド (抜粋)

    フィールド 例 入力テキスト例 説明
    result/param_method_subcat FROMTO 東京から京都まで 応答ドメインのサブカテゴリ
    result/param_from 東京 東京から京都まで TRANSITやMAPなどで起点となる場所
    result/param_to 京都 東京から京都まで TRANSITやMAPなどで終点となる場所
    result/param_place 新宿 新宿の天気 WEATHERやMAPなどで対象となる場所
    result/param_text 眠いときが寝どきです。 眠い SAYなどでの応答文
    result/param_query トゲアリトゲナシトゲトゲ トゲアリトゲナシトゲトゲを検索 SEARCHなどでの検索クエリ


    サンプルレスポンス

    以下は、intext=新宿の天気 のリクエストに対するレスポンスです。

    {
    "result": {
        "intext": "新宿の天気",
        "method": "WEATHER",
        "nvm_that": "新宿",
        "param_method_subcat": "GENERAL",
        "param_place": "新宿",
        "status": "200",
        "var_intext": "新宿の天気",
        "var_intext_normalized": "新宿の天気",
        "var_intext_timestamp": "1514364931",
        "var_test_btsc": "31"
    }
}


    エラー

    自然言語理解はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。



    利用制限

    自然言語理解Web APIは、24時間以内で1つのアプリケーションIDにつき50000件のリクエストが上限となっています。また、1リクエストの最大サイズを100KBに制限しています。詳しくは「利用制限」をご参照ください。