App Inventor 2 指令中文化 FusiontablesControl

FusiontablesControl

您可使用 Google Fusion Tables 來儲存、分享、查詢並將表格視覺化呈現;本元件可讓您查詢、新增與修改這些表格,技術規格請參考 Fusion Tables API V1.0

使用本元件時,需要先定義某一查詢、呼叫 SendQuery 來執行一次查詢,最後由 GotResult 將結果回傳給您。

請注意,您無須擔心查詢的 UTF 編碼問題。但請確認您的查詢語法是按照官方手冊所編寫,例如直行名稱的大小寫是有差的,單筆引用(quote) 中包含空格的話,需要用括號包起來。

查詢結果通常會以 comma-separated values (CSV)的格式來回傳,您可使用 "list from csv table" 或 "list from csv row" 指令將其轉為清單。


使用 FusiontablesControl 元件

取得 API Key

您需要取得一個 Google 的應用程式程式介面金鑰 (API Key) 才能使用 FusiontablesControl 元件。請根據以下步驟來取得API key:

  1. 使用您個人的 Google 帳號登入 Google APIs Console
  2. 在左側選單中,點選 Services 項目。
  3. 在右側清單中找到 Fusiontables 服務,並啟動它。
  4. 回到主選單,並選擇 API Access 項目。 

您的 API Key 會在畫面下方 "Simple API Access" 這一段中,格式長這樣:AIzaSyCIrmOKAuIVNIOY8WjKFogJrAFwbXXXXXX

所有會用到 Fusiontables 的 app,您都需要在其 ApiKey 欄位中填入這個值。

建立 Fusion Tables

開發的過程中,您可能會想要建立專屬的 Fusion Tables 來玩玩看。這和建立 Google 文件一樣簡單。請根據以下步驟來操作:

  1. 請在Google Fusion Table 頁面登入您的 Gmail 或其它任一種 Google 服務帳號(例如Drive、YouTube)。您可以看看一些範例或跟著教學來做做看。
  2. 您應該會看到一些已經建立好的表格或是與您共享的表格,當然也有可能什麼都沒有,因為尚未建立過。
  3. 點選 Create 按鈕來新增表格。幫每一個直行取名字之後存檔。
  4. 點選 Share 按鈕(畫面右上角) 來修改表格的檢視權限。

建立 Fusiontables App

當您在 Designer 頁面中新增一個 FusiontablesControl 元件之後,別忘了設定其 ApiKey 欄位,預設是空白的。請在You should copy this from your Google APIs Console 中啟動 Fusion Tables 服務之後,複製 API Key 之後填入本欄位

APIKey 長這樣:AIzaSyCIrmOKAuIVNIOY8WjKFogJrAFwbXXXXXX



屬性

ApiKey : text (read-only)
在此填入您的 Google API key。要開發使用 Fusiontables 的 app 之前,您得先取得一個 Google API Key。取得 key 的過程如本頁面先前所述。

Query: text (read-only)

要送出給 Fusion Tables API 的查詢。正確的查詢格式與範例,請參閱 Fusion Tables API V1.0 。



事件

GotResult(text result)
處理完一筆 Fusion Tables 查詢後,自動呼叫本事件並回傳結果。查詢結果通常會以 CSV 格式來回傳,您可使用 "list from csv table" 或 "list from csv row" 指令將其轉為清單。



方法


SendQuery()
對 Fusion Tables 伺服器發送一個查詢。


ForgetLogin()
捨棄使用者的帳號名稱,這樣下次要使用 Fusion Table 時就需要重新登入。

Comments