Places Service 中的 「匯入POI」按鈕可用來使用CSV檔案大量上傳新的POI。 提供範例試算表範本,以顯示需要哪些資料欄,以及如何新增可選的自訂中繼資料。
請參閱此影片,其中顯示大量匯入和大量編輯的程式:
已建立一組Python指令碼,以利使用Web服務API,將POI從。csv檔案批次匯入POI資料庫。 這些指令碼可從此開放原始碼 git repo下載。
在您執行這些指令碼之前,若要存取web service API,請參閱「整合概 述」和「必要條件」中的使用者存取必要條件。
以下是有關指令碼的一些資訊:
這些資訊也包含在git repo的讀我檔案 中。
範例。csv檔案 places_sample.csv
是此套件的一部分,包含必要的標題和一列範例資料。 這些標題都是小寫,並對應於Places資料庫中使用的保留中繼資料索引鍵。 您新增至。csv檔案的欄會以每個POI的索引鍵/值配對形式,新增至POI資料庫的個別中繼資料區段,而標題值則用作索引鍵。
以下是您需要使用的欄和值的清單:
lib_id
從POI資料庫取得的有效程式庫ID。
type
Point目前是唯一有效值。
longitude
介於-180和180之間的值。
latitude
介於-85和85之間的值。
radius
值介於10到20,000之間。
Places Service UI中使用下列欄的值:
color,此顏色用作Places服務UI映射中POI位置的PIN顏色。
有效值為「」、#3E76D0、#AA99E8、#DC2ABA、#FC685B、#FC962E、#F6C436、#BECE5D、#61B56b和#3DC8DE和""。
如果值保留為空白,則Places Service UI使用藍色作為預設顏色。
這些值對應藍色(#3E76D0)、紫色(#AA99E8)、fuschia(#DC2ABA)、橘色(#FC685B)、淡橙(#FC962E)、黃色(#F6C436)、淡綠色(#BECE5D)、綠色(#61B56B)和淺藍色(#3DC8DE)。
表徵圖,此表徵圖用作PIN上的表徵圖,該表徵圖代表POI在Places服務UI映射上的位置。
有效值為""、商店、旅館、汽車、火車、船、體育場、娛樂園、錨、燒杯、鐘、投標、書、箱、公事包、瀏覽、筆刷、建築、計算器、相機、鐘、教育、手電筒、追隨者、遊戲、男性、禮物、錘、心、家、鑰匙、啟動、燈泡、郵箱、銷、促銷、緞帶、購物車、星目標,茶壺,拇指向下,拇指向上,陷阱,獎杯,扳手。
圖示值依其在下圖中的顯示順序列出:
如果值保留為空白,UI會使用星號作為預設圖示。
未提及的欄可留空。
從Git repo下載 檔案 ,到您的本機目錄。
在文字編輯器中,開啟 config.py
檔案並完成下列工作:
a.將下列變數值編輯為字串:
csv_file_path
這是您檔案的路 .csv
徑。
access_code
這是您從呼叫Adobe IMS所取得的存取代碼。 如需如何取得此存取程式碼的詳細資訊,請參閱「整合概 述」中的「使用者存取的必要條件」和必要條件。
org_id
要匯入POI的Experience Cloud組織ID。 如需如何取得組織ID的詳細資訊,請參閱「整合概 述」中的使用者存取必要條件和必要條件。
api_key
這是您從Adobe I/O Places整合取得的Places REST API金鑰。 如需如何取得API金鑰的詳細資訊,請參閱「整合概 述」中的使用者存取必要條件和必要條件。
b.儲存您的變更。
在終端窗口中,導航到該 …/places-scripts/import/
目錄。
輸 python ./places_import.py
入並按 enter (return)鍵。
指令碼最初會完成。csv檔案的下列檢查:
是否指 .csv
定檔案。
檔案路徑是否有效。
是否包含保留的中繼資料標題。
保留的中繼資料標題為lib_id、名稱、說明、類型、經度、緯度、半徑、國家、州、城市、街道、類別、圖示和顏色。
標題皆為小寫,可依任何順序列出。
驗證在CSV檔案部分中指定的列的值。
如果發現錯誤,指令碼將打印出錯誤並中止。 如果未找到錯誤,指令碼將嘗試以1000批導入POI。 如果批次成功導入,指令碼將報告狀態代碼200。 如果批未成功導入,則報告錯誤。
設備測試位於文 tests.py
件中,應在每個提取請求之前運行,並且應全部通過。 應新增其他測試與新程式碼。 若要執行測試,請導覽至目 …/places-scripts/import/
錄,然後在 python ./places_import.py
終端機中輸入。