日本語形態素解析

日本語文を形態素に分割し、品詞の推定や活用処理、読みを付与する機能を提供します。

リクエストURL

※GETリクエストには対応していません。
※Client ID（アプリケーションID）をリクエストに付与する必要があります。詳細はサンプルコードをご覧ください。

リクエストパラメータ（POST）

JSON-RPC 2.0の仕様 に準拠しています。

パラメータ	値	説明
id（必須）	string,integer	JSON-RPC 2.0のid。値は任意で、指定した値がレスポンスのidにも返ります。
jsonrpc（必須）	string	値は「2.0」としてください。
method（必須）	string	値は「jlp.maservice.parse」としてください。
params（必須）	object
params/q（必須）	string	解析対象のテキストを指定します。
params/context（任意）	object
params/context/entries （任意）	array（string）	ユーザ辞書として追加したいエントリを指定します。 詳細は ユーザ辞書エントリの追加 仕様をご覧ください。

サンプルリクエスト

{
  "id": "1234-1",
  "jsonrpc" : "2.0",
  "method" : "jlp.maservice.parse",
  "params" : {
    "q" : "美しい水車小屋の娘"
  }
}

サンプルコード

日本語形態素解析を使用したサンプルコードです。

• 形態素解析

レスポンスフィールド

JSON-RPC 2.0の仕様 に準拠しています。

フィールド	値	説明
id	string,integer	リクエストのidの値が返ります。
jsonrpc	string	固定で「"2.0"」が返ります。
result	object	形態素解析の結果です。
result/tokens	array（array）	形態素情報のリストを含みます。
result/tokens/0	string	（形態素情報）表記
result/tokens/1	string	（形態素情報）読みがな
result/tokens/2	string	（形態素情報）基本形表記
result/tokens/3	string	（形態素情報）品詞
result/tokens/4	string	（形態素情報）品詞細分類
result/tokens/5	string	（形態素情報）活用型
result/tokens/6	string	（形態素情報）活用形

サンプルレスポンス

以下は、q=美しい水車小屋の娘 のリクエストに対するレスポンスです。

{
  "id": "1234-1",
  "jsonrpc": "2.0",
  "result": {
    "tokens": [
      [
        "美しい",
        "うつくしい",
        "美しい",
        "形容詞",
        "*",
        "イ形容詞イ段",
        "基本形"
      ],
      [
        "水車",
        "すいしゃ",
        "水車",
        "名詞",
        "普通名詞",
        "*",
        "*"
      ],
      [
        "小屋",
        "こや",
        "小屋",
        "名詞",
        "普通名詞",
        "*",
        "*"
      ],
      [
        "の",
        "の",
        "の",
        "助詞",
        "接続助詞",
        "*",
        "*"
      ],
      [
        "娘",
        "むすめ",
        "娘",
        "名詞",
        "普通名詞",
        "*",
        "*"
      ]
    ]
  }
}

エラー

日本語形態素解析はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードが返ります。

また、リクエストパラメータが本ドキュメント記載の仕様と異なる場合、ステータスコード200でJSON-RPC 2.0の仕様に準拠したレスポンスが返ることがあります。

フィールド	値	説明
id	string, integer	リクエストのidの値が返ります。
jsonrpc	string	固定で「"2.0"」が返ります。
error	object
error/code	integer	JSON-RPC 2.0の仕様に準拠したエラーコードです。
error/message	string	JSON-RPC 2.0の仕様に準拠したエラーメッセージです。

例1：不正なJSONの場合

リクエスト

{
  "id": "1234-1",
  "jsonrpc" : "2.0",
  "method" : "jlp.maservice.parse",
  "params" : {
    "q" : "美しい水車小屋の娘"
  }

レスポンス

{
  "id": null,
  "jsonrpc": "2.0",
  "error": {
    "code": -32700,
    "message": "Parse error"
  }
}

例2：必須のパラメータがない場合

リクエスト

{
  "id": "1234-1",
  "jsonrpc": "2.0",
  "params": {
    "q": "美しい水車小屋の娘"
  }
}

レスポンス

{
  "id": "1234-1",
  "jsonrpc": "2.0",
  "error": {
    "code": -32600,
    "message": "Invalid request"
  }
}

例3：存在しないmethodを指定した場合

リクエスト

{
  "id": "1234-1",
  "method": "invalid.method.name",
  "jsonrpc" : "2.0",
  "params" : {
    "q" : "美しい水車小屋の娘"
  }
}

レスポンス

{
  "id": "1234-1",
  "jsonrpc": "2.0",
  "error": {
    "code": -32601,
    "message": "Method not found"
  }
}

利用制限

日本語形態素解析では、1リクエストの最大サイズを 4KB に制限しています。また、利用回数の制限については利用回数の制限についてをご参照ください。