第1步：入門

我們已經(jīng)為您將大量代碼放在一起并組織信息。我們只需要你一路做一些調(diào)整。如果您想要對我們的代碼進行一些更改并發(fā)送天氣數(shù)據(jù)，那么就有無限可能！

要檢索我們?yōu)槟鷾蕚涞乃袃?nèi)容，您需要從GitHub克隆存儲庫。 GitHub是一項服務(wù)，允許我們存儲，修改和管理這樣的項目。您將需要在專用設(shè)備上運行此腳本。 Raspberry Pi是運行像本教程這樣的應(yīng)用程序的完美選擇。

要克隆存儲庫，我們需要做的就是進入我們的Pi終端，或者通過SSH連接到你的pi的計算機終端并輸入以下命令：

$ git clone https://github.com/InitialState/darksky.git

按Enter鍵，你會看到這個信息：

Cloning into ‘darksky’。..

remote： Counting objects： 2， done.

remote： Total 2 （delta 0）， reused 0 （delta 0）， pack-reused 2

Unpacking objects： 100% （2/2）， done.

Checking connectivity.。. done.

一旦你看到這個，那么恭喜你，你已經(jīng)成功地克隆了GitHub Repo并擁有構(gòu)建這個項目的所有必要文件。在我們繼續(xù)下一步之前，讓我們花一些時間來探索這個目錄并學習一些基本的命令行命令。

在終端中輸入以下命令：

$ ls

此命令列出您當前所在目錄中可用的所有內(nèi)容。此列表顯示我們的GitHub Repo已成功克隆到我們的目錄中，名稱為“darksky”。讓我們看一下該目錄中的內(nèi)容。要移動到目錄，您只需鍵入“cd”，然后鍵入要轉(zhuǎn)到的目錄的名稱。

在這種情況下，我們將輸入：

$ cd darksky

點擊Enter后，您會看到我們現(xiàn)在位于darksky目錄中。讓我們再次輸入“l(fā)s”，看看我們在pi上安裝了哪些文件。

README.md darksky.py 。..

在這里，我們看到我們有自述文件和python文件。讓我們使用“nano”命令查看darksky.py。 nano命令允許我們打開納米文本編輯器，我們擁有該項目每個部分的所有python代碼。繼續(xù)輸入：

$ nano darksky.py

在這里，您可以看到我們?yōu)榇隧椖繙蕚涞乃写a。我們暫時不會對此文檔進行任何更改，但可以隨意滾動查看本教程后面的內(nèi)容。

步驟2：使用Dark Sky API

要使用Dark Sky API，您首先需要自己的API密鑰。不用擔心，獲取API密鑰很快且免費。您只需訪問該網(wǎng)站并點擊“免費試用”即可創(chuàng)建一個帳戶。

每天免費獲得1，000次API調(diào)用。每個免費每日限額的API請求費用為0.0001美元。

此限制會在UTC午夜自動重置。

預測請求會返回下周的當前天氣預報。

Time Machine請求返回過去或?qū)砟硞€日期的觀察或預測天氣狀況。

您的秘密Dark Sky API密鑰將如下所示： 0123456789abcdef9876543210fedcba。

您可以通過以下格式在瀏覽器中輸入URL來對Dark Sky進行API調(diào)用：

https://api.darksky.net/forecast/［key］/［latitude］，［longitude］

用Dark Sky API替換“key”隨心所欲的關(guān)鍵和經(jīng)度/緯度。您可以訪問Google地圖并搜索您的位置來查找經(jīng)度和緯度。這些值將在URL中。使用您的訪問鍵復制并粘貼上面的黑暗天空URL，并將值添加到地址欄中。

執(zhí)行此操作后，您將看到如下內(nèi)容：

{“l(fā)atitude”：37.8267，“l(fā)ongitude”：-122.4233，“timezone”：“America/Los_Angeles”，“currently”：{“time”：1550615286，“summary”：“Clear”，“icon”：“clear-

day”，“nearestStormDistance”：57，“nearestStormBearing”：15，“precipIntensity”：0，“precipProbability”：0，“temperature”：53.9，“apparentTemperature”：53.9，

“dewPoint”：29.59，“humidity”：0.39，“pressure”：1022.45，“windSpeed”：3.87，“windGust”：9.25，“windBearing”：259，“cloudCover”：0.01，“uvIndex”：3，

“visibility”：7.8，“ozone”：309.71}，“minutely”：{“summary”：“Clear for the hour.”，“icon”：“clear-day”，“data”：［

{“time”：1550615280，“precipIntensity”：0，“precipProbability”：0}，。..

它可能有點壓倒性且難以閱讀，因此我建議使用JSON Formatter來幫助使數(shù)據(jù)更具可讀性。當你這樣做時，它看起來像這樣：

object {9}

latitude： 37.8267

longitude： -122.4233

timezone： America/Los_Angeles

currently {19}

time： 1550615286

summary： Clear

icon： clear-day

nearestStormDistance： 57

nearestStormBearing： 15

precipIntensity： 0

precipProbability： 0

temperature： 53.9

apparentTemperature： 53.9

dewPoint： 29.59

humidity： 0.39

pressure： 1022.45

windSpeed： 3.87

windGust： 9.25

windBearing： 259

cloudCover： 0.01

uvIndex： 3

visibility： 7.8

ozone： 309.71

你剛剛進行了API調(diào)用！看看這有多容易？你甚至不必寫一行代碼。現(xiàn)在您已經(jīng)掌握了API，我們可以轉(zhuǎn)到數(shù)據(jù)流部分。

第3步：初始狀態(tài)

我們我們希望將所有天氣數(shù)據(jù)流式傳輸?shù)皆品?wù)，并將該服務(wù)轉(zhuǎn)換為我們可以從筆記本電腦或移動設(shè)備訪問的漂亮儀表板。我們的數(shù)據(jù)需要目的地。我們將使用初始狀態(tài)作為該目的地。

步驟1：注冊初始狀態(tài)帳戶

轉(zhuǎn)到https：//iot.app.initialstate。 com并創(chuàng)建一個新帳戶。您可以獲得14天的免費試用，任何擁有edu電子郵件地址的人都可以注冊免費的學生計劃。

步驟2：安裝ISStreamer

將初始狀態(tài)Python模塊安裝到Raspberry Pi上。在命令提示符下，運行以下命令：

$ cd /home/pi/

$ \curl -sSL https://get.initialstate.com/python -o - | sudo bash

步驟3：進行一些Automagic

在步驟2之后，您將看到類似于以下輸出的內(nèi)容到屏幕：

pi@raspberrypi ~ $ \curl -sSL https://get.initialstate.com/python -o - | sudo bash

Password：

Beginning ISStreamer Python Easy Installation！

This may take a couple minutes to install， grab some coffee ：）

But don‘t forget to come back， I’ll have questions later！

Found easy_install： setuptools 1.1.6

Found pip： pip 1.5.6 from /Library/Python/2.7/site-packages/pip-1.5.6- py2.7.egg （python 2.7）

pip major version： 1

pip minor version： 5

ISStreamer found， updating.。.

Requirement already up-to-date： ISStreamer in /Library/Python/2.7/site-packages

Cleaning up.。.

Do you want automagically get an example script？ ［y/N］

Where do you want to save the example？ ［default： 。/is_example.py］

Please select which Initial State app you‘re using：

1. app.initialstate.com

2. ［NEW！］ iot.app.initialstate.com

Enter choice 1 or 2：

Enter iot.app.initialstate.com user name：

Enter iot.app.initialstate.com password：

當系統(tǒng)詢問您是否要自動獲取示例腳本時，將“y”設(shè)置為yes并按Enter鍵將腳本保存在默認位置。有關(guān)您使用的應(yīng)用程序的問題，請選擇2（除非您在2018年11月之前注冊）并輸入您的用戶名和密碼。

步驟4：運行示例腳本

運行測試腳本以確保我們可以為您的初始狀態(tài)帳戶創(chuàng)建數(shù)據(jù)流。編寫以下命令：

$ python is_example.py

步驟6：示例數(shù)據(jù)

在Web瀏覽器中返回初始狀態(tài)帳戶。一個名為“Python Stream Example”的新數(shù)據(jù)桶應(yīng)該出現(xiàn)在日志架的左側(cè)（您可能需要刷新頁面）。點擊此桶查看您的數(shù)據(jù)。

步驟4：Dark Sky天氣儀表板

現(xiàn)在為有趣的部分。我們已準備好開始使用Dark Sky API創(chuàng)建天氣儀表板并捕獲我們選擇的位置的天氣歷史記錄。為此，我們將使用Python腳本：https：//github.com/initialstate/darksky/blob/master/darksky.py。此腳本只需使用您的API密鑰調(diào)用Dark Sky API，并在指定的時間間隔內(nèi)檢索天氣信息。它還將該數(shù)據(jù)流式傳輸?shù)侥某跏紶顟B(tài)帳戶，這將允許您創(chuàng)建Dark Sky天氣儀表板。

您可以將此腳本復制到Pi，或通過我們克隆的GitHub存儲庫訪問它早。您可以通過鍵入以下命令更改為darksky目錄來執(zhí)行此操作：

$ cd darksky

從這里，您將能夠訪問我們將運行的python文件以創(chuàng)建我們的天氣儀表板。在運行之前，您需要設(shè)置所需的參數(shù)并插入密鑰。通過鍵入以下內(nèi)容將Nano納入darksky.py文件中：

$ nano darksky.py

然后編輯腳本頂部附近的部分：

# --------- User Settings ---------

CITY = “Nashville”

GPS_COORDS = “36.1628414，-86.780199”

DARKSKY_API_KEY = “PLACE YOUR DARK SKY API KEY HERE”

BUCKET_NAME = “：partly_sunny： ” + CITY + “ Weather”

BUCKET_KEY = “ds1”

ACCESS_KEY = “PLACE YOUR INITIAL STATE ACCESS KEY HERE”

MINUTES_BETWEEN_READS = 15

# ---------------------------------

您需要設(shè)置所需的GPS坐標和城市名稱。您還必須插入您的Dark Sky API密鑰和您的初始狀態(tài)帳戶訪問密鑰，否則您的數(shù)據(jù)將無處可去。 MINUTES_BETWEEN_READS參數(shù)將設(shè)置腳本輪詢Dark Sky API獲取天氣信息的頻率。 15分鐘長期提供良好的間隔。為了進行短期測試，您可以將其設(shè)置為0.5分鐘。進行更改，然后輸入control + X退出并保存。

設(shè)置好參數(shù)后，就可以運行腳本了：

$ python darksky.py

如果你是ssh’ing到你的Pi并希望讓這個腳本長時間不間斷地運行，你可以使用nohup命令（沒有掛斷），如下所示：

$ nohup python darksky.py &

這個腳本正在運行要做的不僅僅是閱讀天氣數(shù)據(jù)并將其發(fā)送到初始狀態(tài)。該腳本將利用Initial State工具中內(nèi)置的表情符號支持，使儀表板更加酷炫。您可以看到用于從當前 - 》圖標獲取天氣狀態(tài)的邏輯，并將其轉(zhuǎn)換為weather_icon功能中的表情符號標記。類似于moon_icon函數(shù)中的月相和wind_dir_icon函數(shù)中的風向。

步驟5：結(jié)論

轉(zhuǎn)到您的初始狀態(tài)帳戶并查看您的數(shù)據(jù)。我將所有百分比值更改為電弧規(guī)，將液體壓力降至液位計，將溫度更改為溫度計。您可以更改為任何類型的瓷磚類型，并選擇您的顏色和儀表。折線圖。您可以將儀表板設(shè)置為暗或亮，并使用嵌入式iFrame將最終產(chǎn)品嵌入到網(wǎng)站中。

如果要將公共共享中的儀表板布局用作儀表板，則可以將布局導入按照此處的說明操作您的數(shù)據(jù)桶。