Code Monkey home page Code Monkey logo

ambient-nodejs-lib's Introduction

ambient-lib Ambientのnode.jsライブラリー

このリポジトリは古いです。最新版はこちらをご覧ください。

Ambient

AmbientはIoTデータ可視化サービスで、センサーデーターを受信し、蓄積し、可視化(グラフ化)します。

Ambient structure

Ambientにユーザー登録(無料)し、マイコンからデーターを送ると、こんな感じでグラフ表示させることができます。

Ambient chart

ambient-libはAmbientのnode.jsライブラリーです。

インストール

$ npm install ambient-lib

モジュールの読み込み

var ambient = require('ambient-lib');

Ambientへの接続

ambient.connect(チャネルId, ライトキー[, リードキー[, ユーザーキー]]);

Ambientにデーターを送信するときは、チャネルIdとライトキーを指定してAmbientに接続します。

Ambientへのデーター送信

ambient.send(data, callback(err, res, body));
  • パラメーター
  • data: 次のようなJSON形式で、キーはd1からd8のいずれかを指定します。
var data = {d1: 1.1, d2: 2.2};
  • callback: データー送信後に呼ばれるコールバック関数。パラメーターはrequestモジュールのコールバック関数のパラメーターと同じです。

こんな風に使います。

ambient.send({d1: 1.1, d2: 2.2}, function(err, res, body) {
    if (err) {
        console.log(err);
    }
    console.log(res.statusCode);
});

この形式でデーターを送信した場合、Ambientはデーターを受信した時刻を合わせて記録します。 次のようにデーターを測定した時刻を指定することもできます。

var data = {created: 'YYYY-MM-DD HH:mm:ss.sss', d1: 1.1, d2: 2.2};

また、次のように複数のデーターを一括で送信することもできます。

var data = [
    {created: '2017-02-18 12:00:00', d1: 1.1, d2: 2.1},
    {created: '2017-02-18 12:01:00', d1: 1.5, d2: 3.8},
    {created: '2017-02-18 12:02:00', d1: 1.0, d2: 0.8}
];

以前は複数データーの一括送信はbulk_send()という関数を提供していましたが、send()で1データーでも複数データーでも送信できるように拡張しました。 bulk_send()は互換性のために残してあります。

Ambientへの複数データー一括送信

複数データー一括送信も用意しました。

ambient.bulk_send(dataarray, callback(err, res, body));
  • パラメーター
  • dataarray: 次のような形式の配列です。 createdはデーターの生成時刻で、値は“YYYY-MM-DD HH:mm:ss.sss”という形式か、 数値を渡します。 数値を渡した場合は1970年1月1日00:00:00からのミリ秒と解釈されます。
var dataarray = [
    {created: '2016-07-07 12:00:00', d1: 1.1, d2: 2.1},
    {created: '2016-07-07 12:01:00', d1: 1.5, d2: 3.8},
    {created: '2016-07-07 12:02:00', d1: 1.0, d2: 0.8}
];

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.