IMD 喫食管理APIシステム / IMD Meal Tracking API System

API活用例Example Use Cases

APIの構成API Components

IMD 喫食管理APIシステムは、主に「検索」「記録」「分析」の３部で構成されています。The IMD Meal Tracking API System consists of three main parts: Search, Record, and Analytics.

検索APISearch API

「何を食べたか」をデジタル化する基本機能を提供します。
食事情報を構成するためには、食べた「食品」を弊社食品栄養データベースで管理する「食品データ」と同定する必要があります。「同定する」ことの主語は、「食べた本人」が一般的であり、アプリの場合には「アプリを使う人（＝エンドユーザ）」が検索することから始まります。
最近ではこの検索作業が面倒だということで、画像認識技術を採用することも増えていますが、現状においては中々精度は難しいところがあり、精度が必要な検証などでは利用は困難です。しかし、ある程度のラフな記録で良い場合においては、有効とされています。
※現在、画像認識サービスにおいて、その認識候補結果として弊社食品データ識別子（OID)が直接出力されるように、準備・調整致しております。
いずれにせよ、食べた「食品」を「１食」としてまとめ、「食事」（複数の食品で構成される1食）を構成し、日時など付帯情報、各食品毎の分量を付与し、「食事情報」を成立させるための機能を、検索APIでは提供します。 Provides core functionality to digitize “what you ate”.
To build a meal record, the foods you ate must be matched to “Food” data managed in our Food Nutrition Database. Typically the eater is the one who performs this matching; in an app, this starts with the end user searching for foods.
Recently, image recognition is sometimes adopted because searching can feel tedious. However, accuracy is still challenging today, so it can be difficult to use for studies or validations that require high precision. For rough logging, it can be effective.
* We are currently preparing and adjusting so that image recognition services can directly output our Food Data Identifier (OID) as a candidate result.
In any case, the Search API provides functions to group eaten foods into a single meal, add metadata such as date/time and portions per food, and complete a structured meal record.

記録APIRecord API

食事情報を「保存」する機能を提供します。
弊社記録APIに保存すると、弊社記録データベースに保存されますが、保存するだけでは意味はなく、後述の分析APIを利用する場合で、且つ、期間の長いものについて又は一定のグループにおいて分析を実施する場合においては、特に有効です。
※多量の食事情報データを分析毎に送受信する事を避けるために、合理的になります。
しかし、貴社がアプリを提供していて、記録するストレージを管理できている場合には、そのストレージで保存するのも、セキュリティ管理の点においても有効でしょう。ただしかし、分析APIを利用する場合においては、この点はご相談下さい。 Provides functionality to save meal records.
When you save via our Record API, the data is stored in our record database. Storing alone is not the goal, but it becomes especially useful when you use the Analytics API and analyze longer periods or a defined group.
* This is rational because it avoids sending/receiving large volumes of meal data for every analysis.
If your app can manage its own storage for logging, saving on your side can also be effective from a security-management perspective. However, if you plan to use the Analytics API, please consult us about this point.

分析APIAnalytics API

保存された食事情報を「分析」する機能を提供します。
弊社食品栄養データベースは、約40万件の全ての「食品」について食材構成情報を有し、例えば「ラーメン」なら、中華麺〇〇g、スープ〇〇g、ネギ・・・・のような形です。各食材は文科省定義の食品標準成分表に則り作成されているため、同成分表が定義する全栄養素（約180種類前後）はもちろんのこと、弊社独自の栄養成分や商品においては流通に関する情報やメーカーや店舗などの社店名、分類カテゴリやタグ、そしてこれら情報により分類又はスコアリングする「SV値」「6分類」「Nutri-score」など多彩な情報を、「全て」活用できる分析エンジンを独自開発しました。
分析エンジンの動作について、管理栄養士の指導方法にも様々な手法があるのと同じく分析する着眼点や目的、対象によって自在に設定できるように、管理栄養士らが、Webから高度な動作指定（ルール設定）ができる分析API 管理Webシステムもご用意致しましたので、「分析API エンジン部」と「分析API 設定管理部」で構成される分析APIにより、全く新しい食事分析サービスを実現できます。 Provides functionality to analyze saved meal records.
Our Food Nutrition Database contains ingredient composition information for about 400,000 foods. For example, “ramen” may be represented as Chinese noodles xx g, soup xx g, green onion, etc. Each ingredient is created in accordance with Japan’s Standard Tables of Food Composition, so you can use all defined nutrients (around 180 types). In addition, we provide proprietary nutrients and, for products, distribution-related information, manufacturer/store names, categories and tags, and classification/scoring based on these (e.g., SV value, 6-category classification, Nutri-Score). We developed an analytics engine that can leverage all of this information.
Just as dietitians use various guidance methods, analytics viewpoints, purposes, and targets vary. To allow flexible configuration, we also provide a management web system where registered dietitians can specify advanced behavior (rule settings). With the Analytics API—composed of an “engine” and “configuration management”—you can build entirely new meal analysis services.

3種類のAPI種別Three API Types

一般にITによる喫食管理において、食事内容を確認し、内容を記録し、記録された食事内容を分析することで、ダイエットや栄養指導や、レコメンドなどを喫食対象者（エンドユーザさま）にご提供します。 In IT-based meal tracking, you confirm meal contents, record them, and analyze recorded meals to provide dieting, nutrition guidance, recommendations, and more to end users.

検索APIさえあれば、基本的な食品検索や、その中で得られる栄養素による充足率判断も実現できます。検索の際にはキーワードやカテゴリなどを指定することができ、栄養素やキーワードやカテゴリなど、さまざまなフィルタやソート機能も搭載しています。 With the Search API alone, you can implement basic food search and evaluate adequacy based on nutrients returned. You can specify keywords and categories, and use various filters and sorting by nutrients, keywords, categories, and more.

単食だけでなく、１日、数日、週間、月間、年間で「比較評価」したい場合には、検索APIの他に、記録API×分析APIを活用すると実現できます。 If you want comparative evaluation not only per meal but also by day, multiple days, week, month, or year, you can achieve this by using the Record API and Analytics API in addition to the Search API.

但し、検索APIの検索結果（＝レスポンスであり、記録）において栄養素を付与された場合、貴社自身でも栄養素を積算するなどして保存できるため、通常のアプリ開発では、記録APIは必ずしも必須ではありません。※しかし「長期間の比較評価」や「食事分析代行」機能ご利用の際には必要となります。 If nutrients are included in Search API responses (which can serve as records), you can also store them on your side by aggregating nutrients, so the Record API is not strictly required for typical app development. * However, it is needed for long-term comparative evaluation and for using the meal analysis outsourcing service.

記録された食事データを使った、高度な分析を実施するのが分析APIとなります。食事記録を、分析APIに対してアクセス毎に引数として付与し送信する形式と、記録APIで保存した食事を参照する、2種類の分析データの情報伝達方法があります。 The Analytics API performs advanced analysis using recorded meal data. There are two ways to provide data: send meal records as parameters on each Analytics API request, or reference meals saved via the Record API.

分析結果取得例Example: Getting Analysis Results

分析APIの利用だけでなく、Microsoft Excelで扱えるCSV形式で食事内容の詳細リストをご提供する「食事分析代行」サービスもご用意しています。※この場合、記録APIで食事を記録する必要があります。 In addition to using the Analytics API, we also offer the Meal Analysis Outsourcing service, which provides a detailed list of meal contents in CSV format (compatible with Microsoft Excel). * In this case, meals must be recorded via the Record API.

開発支援Development Support

API引数などをWebで確認できる開発支援ユーティリティをご提供しています。We provide development support utilities that let you check API parameters and more via the web.

各種用途への対応Use Cases & Support

喫食管理に関するサービスや機能を必要としたとき、以下のようなケースがよくあります。
これらケースに全てIMDでは対応できる準備がありますが、その背景やニーズをご相談頂き、適切なサービスや機能をご提供致します。
※代理店さまを通じてご紹介頂いた案件などは、その道義に則り対処致します。 When you need meal-tracking services or functions, the following cases are common.
IMD is prepared to support all of these; please share your background and needs so we can provide the right service and functionality.
* For projects introduced via agencies/partners, we will respond in accordance with professional ethics.

貴社にIT部門があり、新たなサービスを自社内製をするケースYou have an IT department and plan to build a new service in-house
開発は他社に委託するケースYou outsource development to another company
研究所等での調査のために被験者が何を食べたかの情報を栄養成分や食材で知りたいケースFor research/surveys, you want to know what subjects ate in terms of nutrients and ingredients
テーマや目的が明確で喫食管理サービスをOEMで良いのでスグに自社展開したいケースYou have a clear goal and want to quickly roll out an OEM meal-tracking service

シンプルな食事検証Simple Meal Study

IMDでは、昨今の日本におけるLINE利用者などを鑑み、従来は独自検証用アプリをご提供しておりましたが廃止し、LINEによって食事検証ができるシステムを開発しました。
ITが不得意な方は「食事写真を送信するだけ」で、一般の方はWebやLINEのチャットボットを通じて食品名から検索して記録することで、特別なアプリをインストールすることなく、比較的簡単に食事記録を実現できます。
記録内容は、分析APIでの分析や、一定の事前承諾を得た被験者（利用時に認証します）に関する食事内容の詳細をご提示するサービスでもご活用いただます。 Considering the widespread use of LINE in Japan, IMD previously provided a dedicated validation app, but we have discontinued it and developed a system that enables meal studies via LINE.
For people who are not comfortable with IT, they can “just send meal photos”. General users can search foods by name and log them via the web or a LINE chatbot, enabling relatively easy meal logging without installing a special app.
Logged data can be used for analytics via the Analytics API, and also for services that present detailed meal contents for subjects who have given prior consent (authenticated at use).

その他Notes

各種APIについては、全て原則、年間ご契約となります。
※ライセンスにてご提供するため、ご利用前払いとさせて頂いております。
※最短３カ月のご契約もありますが、割増ご料金対象となりますのでご容赦下さい。In principle, all APIs are contracted on an annual basis.
* Provided as a license, so payment is required in advance.
* A minimum 3-month contract is available, but a surcharge applies.
各種APIについては、それぞれについて仕様が定義されていますので、お問合せ下さい。
※トライアル・試用は、合理的な理由がない限り原則としてお断りしています。
※動作実証確認のため、幾つかの確認用サービスをご提供している場合がありますので、お問合せ下さい。
※弊社定義の仕様でAPIが動作をしない場合は、ご契約に基づき、適切に対処致します。Each API has defined specifications; please contact us for details.
* Trials/evaluations are generally not offered unless there is a reasonable reason.
* For proof-of-operation, we may provide some verification services; please ask.
* If the API does not operate according to our defined specifications, we will respond appropriately based on the contract.
各種APIについては、仕様外の動作をご希望の場合も、お問合せ下さい。
※弊社は内製100％対処を致しておりますので、責任をもって対応させて頂きます。If you need behavior outside the specifications, please contact us.
* We handle development 100% in-house and will respond responsibly.
その他、詳細についてはお客様担当へお問合せ下さい。For other details, please contact your account representative.

IMD 喫食管理APIシステムIMD Meal Tracking API System