自然言語理解

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

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

リクエストURL

リクエストパラメータ

仕様

パラメータ	値	説明
appid（必須）	string	アプリケーションID。詳細はこちらをご覧ください。
intext（必須）	string	解析対象のテキストです。
sample<n>	string	カスタムルール。詳細はカスタムルールの追加 仕様をご覧ください。
dict<n>	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は、1リクエストの最大サイズを100KBに制限 しています。また、利用回数の制限については利用回数の制限についてをご参照ください。