大量上傳POI bulk-upload-pois
此 匯入POI Places服務中的按鈕可用於透過CSV檔案大量上傳新的POI。 範例試算表範本可顯示哪些資料欄是必要欄以及如何新增選用自訂中繼資料。
請觀看這段影片,瞭解大量匯入和大量編輯的程式:
Python API指令碼
已建立一組Python指令碼,以簡化使用Web服務API將.csv檔案中的POI批次匯入POI資料庫的過程。 這些指令碼可從此開放原始碼下載 git存放庫.
執行這些指令碼之前,若要存取Web服務API,請參閱 使用者存取的必要條件 在 整合概述和先決條件.
以下是有關指令碼的一些資訊:
CSV檔案
範例.csv檔案、 places_sample.csv
,是此套件的一部分,並包含必要的標頭和一列範例資料。 這些標題全部為小寫,且對應至Places資料庫中使用的保留中繼資料索引鍵。 您新增至.csv檔案的欄將以索引鍵/值組的形式新增至POI資料庫中每個POI的獨立中繼資料區段,而標頭值則作為索引鍵。
以下是您需要使用的欄和值清單:
-
lib_id
從POI資料庫取得的有效資料庫ID。
-
type
點是目前唯一的有效值。
-
longitude
介於–180到180之間的值。
-
latitude
介於–85到85之間的值。
-
radius
介於10到20,000之間的值。
欄值
下列各欄的值會用於Places服務UI:
-
顏色,用來作為代表POI在Places服務UI地圖中位置的圖釘顏色。
-
有效值為「」、#3E76D0、#AA99E8、#DC2ABA、#FC685B、#FC962E、#F6C436、#BECE5D、#61B56B和#3DC8DE以及「」。
-
如果值保留為空白,Places服務UI會使用藍色作為預設顏色。
值分別對應至藍色(#3E76D0)、紫色(#AA99E8)、Fuschia (#DC2ABA)、橙色(#FC685B)、淺橙色(#FC962E)、黃色(#F6C436)、淺綠色(#BECE5D)、綠色(#61B56B)和淺藍色(#3DC8DE)。
-
-
圖示,用來當作圖釘上的圖示,代表Places服務UI地圖上POI的位置。
-
有效值包括「」、商店、旅館、汽車、飛機、火車、船、體育場、遊樂場、錨點、燒杯、鈴、出價、書、盒子、公事包、瀏覽、筆刷、建築物、電腦、相機、時鐘、教育、手電筒、追蹤、遊戲、女性、男性、禮物、槌子、心、家、鑰匙、啟動、燈泡、信箱、錢、圖釘、促銷活動、帶狀圖、購物車、星星、目標、茶壺、thumbDown、thumbUp、陷阱、獎盃、扳手。
圖示值會依照其顯示順序如下圖所示:
-
如果值保留為空白,UI會使用星形作為預設圖示。
-
-
未提及的欄可保留空白。
執行指令碼
-
從下載檔案 git存放庫 至您的本機目錄。
-
在文字編輯器中,開啟
config.py
檔案並完成下列工作:a.將下列變數值編輯為字串:
-
在終端機視窗中,瀏覽至
…/places-scripts/import/
目錄。 -
輸入
python ./places_import.py
並按下 輸入 (return)鍵。
預先匯入CSV檢查
指令碼最初會完成對.csv檔案的下列檢查:
-
是否
.csv
已指定檔案。 -
檔案路徑是否有效。
-
是否包含保留的中繼資料標題。
保留的中繼資料標題為lib_id、名稱、說明、型別、經度、緯度、半徑、國家/地區、州、城市、街道、類別、圖示和顏色。
note tip TIP 標題全部為小寫,可依任何順序列出。 -
驗證CSV檔案區段中指定之欄的值。
如果發現錯誤,指令碼會列印出錯誤並中止。 如果未發現錯誤,指令碼會嘗試以1000的批次匯入POI。 如果成功匯入批次,指令碼會報告狀態代碼200。 如果批次未成功匯入,則會報告錯誤。
單元測試
單元測試位於 tests.py
檔案時,應在每個提取請求之前執行,且應全部通過。 應使用新程式碼新增其他測試。 若要執行測試,請導覽至 …/places-scripts/import/
目錄,並輸入 python ./places_import.py
在終端機中。