API

時刻情報正規化API

2016/03/31

時刻情報正規化APIの概要

時刻情報正規化APIはリクエストで送られた日本語文字列と日時情報から、日付や時刻を表す表現を抜き出しその値を正規化して返却します。
例えば、「今日の9時」という文字列が"2016-04-01T08:16:32"の時刻情報と同時に送られた場合、「今日」の部分を「2016-04-01」、「9時」を「2016-04-01T09」と正規化します。

このAPIを用いることによって、「明後日の午後2時半にメールを送って」といった入力から具体的な日時を抽出できるため、音声入力による操作を行うアプリケーションを作成することが可能となります。

リクエスト先URL

https://labs.goo.ne.jp/api/chrono

リクエストパラメータ

application/x-www-form-urlencoded、application/json形式でのPOSTを受け付けます。
※GETは受け付けませんのでご注意ください。

パラメータ名 説明
app_id
(必須項目)
アプリケーションID
request_id リクエストID
省略時は"labs.goo.ne.jp[タブ文字]リクエスト受付時刻[タブ文字]連番"となります。
sentence
(必須項目)
解析対象テキスト
doc_time 日時情報
"%Y-%m-%dT%H%M%S"のフォーマットで基準となる日時を指定する。
省略時には現在時刻が用いられます。

レスポンスパラメータ

JSONフォーマットのテキスト形式となります。
Content-typeは"application/json"となります。

パラメータ名 説明
request_id リクエストと同じ値となります。
doc_time リクエストと同じ値となります。
datetime_list 日時表現リスト
正規化された日時情報を持つ配列。
各要素は、日時表現とYYYY-mm-ddTHH:MM:SSのフォーマットに正規化された時刻情報の配列となります。

・抽出された日時情報までを出力し、それよりも後部は省略されます。例えば、日付のみしか取得されない場合の時刻情報は"2016-04-01"となります。
・「今日の2時」といった午前・午後のどちらにも取れる表現については、日中時間帯と解釈し"2016-04-01T14"といった出力となるようにチューニングを行っております。
・「2月の30日」や「深夜26時」といった表現は翌月や翌日に繰り上がるようにしております。

入出力サンプル

入力例: Input sample

{"app_id":"[発行されたapp_id]", "request_id":"record007", "sentence":"今日の10時半に出かけます。", "doc_time":"2016-04-01T09:00:00"}

出力例: Output sample

{"request_id":"record007","doc_time":"2016-04-01T09:00:00","datetime_list":[["今日", "2016-04-01"],["10時半", "2016-04-01T10:30"]]}

APIを利用するための手順についてはこちらで説明していますので、ぜひご活用ください。
利用登録はこちらからお願いします。

当APIを活用したWEBサービス、アプリも歓迎致します。商用利用に関するご相談はこちらからお問い合わせお願い申し上げます

APIコンソール

開く

日本語解析API一覧

■形態素解析API
日本語文字列を、形態素と呼ばれる意味を持つ最小限の単語単位に分割します
■固有表現抽出API
日本語文字列から、人名や地名、日付表現などの固有表現を抽出します
■語句類似度算出API
キーワードについて、その語句の発音内容を比較してその類似度を算出します
■ひらがな化API
日本語文字列を、ひらがな もしくは カタカナ による記載に変換します
■商品評判要約API
商品レビュー記事の集合から要約文を生成します
■キーワード抽出API
人名や地名、組織など文書を特徴づけるキーワードを抽出します
■時刻情報正規化API
時刻情報となる部分を抽出しそれらを正規化した値を生成します