テキスト解析
日本語係り受け解析 (V1)
こちらはクローズ済み旧バージョンのAPIです。 現行のバージョンに関してはこちらをご覧ください。
リクエストURL
XML
https://jlp.yahooapis.jp/DAService/V1/parse
日本語文の係り受け関係を解析する機能を提供します。
リクエストパラメータ
「RESTリクエストの構築（GET）」および、「RESTリクエストの構築（POST）」をご参照ください。
| パラメータ | 値 | 説明 |
|---|---|---|
| appid（必須） | string | アプリケーションID。詳細はこちらをご覧ください。 |
| sentence（必須） | string | 解析対象のテキストです。解析可能な単位は1文のみとなります。 |
サンプルリクエストURL
https://jlp.yahooapis.jp/DAService/V1/parse?サンプルコード
日本語係り受け解析を使用したサンプルコードです。
レスポンスフィールド
日本語係り受け解析のスキーマの記述は、以下のURLをご覧ください。
https://jlp.yahooapis.jp/DAService/V1/parseResponse.xsd
| フィールド | 説明 |
|---|---|
| ResultSet | 係り受け解析結果のすべてを含みます。 |
| Result | 文節ごとの変換結果で各個別レスポンスを含みます。 |
| ChunkList | 文節の情報群です。 |
| Chunk | 文節の情報を含みます。 |
| Id | 文節の番号を表します。 |
| Dependency | 修飾するIdを返します。 |
| MorphemList | 形態素情報のリストを返します。 |
| Morphem | 形態素の情報を含みます。 |
| Surface | 形態素の表記を表します。 |
| Reading | 形態素の読みがなを表します。 |
| Baseform | 形態素の基本形表記を表します。 |
| POS | 形態素の品詞を表します。 |
| Feature | 形態素の全情報を文字列で返します。 |
サンプルレスポンス
以下は、sentence=うちの庭には二羽鶏がいます。のリクエストに対するレスポンスです。
<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet xsi:schemaLocation="urn:yahoo:jp:jlp:DAService https://jlp.yahooapis.jp/DAService/V1/parseResponse.xsd">
<Result>
<ChunkList>
<Chunk>
<Id>0</Id>
<Dependency>1</Dependency>
<MorphemList>
<Morphem>
<Surface>うち</Surface>
<Reading>うち</Reading>
<Baseform>うち</Baseform>
<POS>名詞</POS>
<Feature>名詞,地名町名,*,うち,うち,うち</Feature>
</Morphem>
<Morphem>
<Surface>の</Surface>
<Reading>の</Reading>
<Baseform>の</Baseform>
<POS>助詞</POS>
<Feature>助詞,助詞連体化,*,の,の,の</Feature>
</Morphem>
</MorphemList>
</Chunk>
<Chunk>
<Id>1</Id>
<Dependency>3</Dependency>
<MorphemList>
<Morphem>
<Surface>庭</Surface>
<Reading>にわ</Reading>
<Baseform>庭</Baseform>
<POS>名詞</POS>
<Feature>名詞,名詞場所,*,庭,にわ,庭</Feature>
</Morphem>
<Morphem>
<Surface>に</Surface>
<Reading>に</Reading>
<Baseform>に</Baseform>
<POS>助詞</POS>
<Feature>助詞,格助詞,*,に,に,に</Feature>
</Morphem>
<Morphem>
<Surface>は</Surface>
<Reading>は</Reading>
<Baseform>は</Baseform>
<POS>助詞</POS>
<Feature>助詞,係助詞,*,は,は,は</Feature>
</Morphem>
</MorphemList>
</Chunk>
<Chunk>
<Id>2</Id>
<Dependency>3</Dependency>
<MorphemList>
<Morphem>
<Surface>二羽</Surface>
<Reading>2わ</Reading>
<Baseform>2羽</Baseform>
<POS>接尾辞</POS>
<Feature>接尾辞,助数,*,二羽,2わ,2羽</Feature>
</Morphem>
<Morphem>
<Surface>鶏</Surface>
<Reading>にわとり</Reading>
<Baseform>鶏</Baseform>
<POS>名詞</POS>
<Feature>名詞,名詞,*,鶏,にわとり,鶏</Feature>
</Morphem>
<Morphem>
<Surface>が</Surface>
<Reading>が</Reading>
<Baseform>が</Baseform>
<POS>助詞</POS>
<Feature>助詞,格助詞,*,が,が,が</Feature>
</Morphem>
</MorphemList>
</Chunk>
<Chunk>
<Id>3</Id>
<Dependency>-1</Dependency>
<MorphemList>
<Morphem>
<Surface>い</Surface>
<Reading>い</Reading>
<Baseform>い</Baseform>
<POS>動詞</POS>
<Feature>動詞,一段,未然ウ接続,い,い,い</Feature>
</Morphem>
<Morphem>
<Surface>ます</Surface>
<Reading>ま</Reading>
<Baseform>ま</Baseform>
<POS>助動詞</POS>
<Feature>助動詞,助動詞ます,基本形,ます,ま,ま</Feature>
</Morphem>
<Morphem>
<Surface>。</Surface>
<Reading>。</Reading>
<Baseform>。</Baseform>
<POS>特殊</POS>
<Feature>特殊,句点,*,。,。,。</Feature>
</Morphem>
</MorphemList>
</Chunk>
</ChunkList>
</Result>
</ResultSet>
エラー
日本語係り受け解析はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
日本語係り受け解析Web APIは、24時間以内で1つのアプリケーションIDにつき50000件のリクエストが上限となっています。また、1リクエストの最大サイズを4KBに制限しています。詳しくは「利用制限」をご参照ください。
