大量上傳POI

Places Service 中的 「匯入POI」按鈕可用來使用CSV檔案大量上傳新的POI。 提供範例試算表範本,以顯示需要哪些資料欄,以及如何新增可選的自訂中繼資料。

批量導入螢幕

請參閱此影片,其中顯示大量匯入和大量編輯的程式:

放置服務批量導入和編輯POI

Python API指令碼

已建立一組Python指令碼,以利使用Web服務API,將POI從。csv檔案批次匯入POI資料庫。 這些指令碼可從此開放原始碼 git repo下載

在您執行這些指令碼之前,若要存取web service API,請參閱「整合概 述」和「必要條件」中的​使用者存取必要條件

以下是有關指令碼的一些資訊:

小費

這些資訊也包含在git repo的讀我檔案

CSV檔案

範例。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會使用星號作為預設圖示。

  • 未提及的欄可留空。

運行指令碼

  1. 從Git repo下載 檔案 ,到您的本機目錄。

  2. 在文字編輯器中,開啟 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.儲存您的變更。

  3. 在終端窗口中,導航到該 …/places-scripts/import/ 目錄。

  4. python ./places_import.py 入並按 enter (return)鍵。

預先匯入CSV檢查

指令碼最初會完成。csv檔案的下列檢查:

  • 是否指 .csv 定檔案。

  • 檔案路徑是否有效。

  • 是否包含保留的中繼資料標題。

    保留的中繼資料標題為lib_id、名稱、說明、類型、經度、緯度、半徑、國家、州、城市、街道、類別、圖示和顏色。

    小費

    標題皆為小寫,可依任何順序列出。

  • 驗證在CSV檔案部分中指定的列的值。

如果發現錯誤,指令碼將打印出錯誤並中止。 如果未找到錯誤,指令碼將嘗試以1000批導入POI。 如果批次成功導入,指令碼將報告狀態代碼200。 如果批未成功導入,則報告錯誤。

設備測試

設備測試位於文 tests.py 件中,應在每個提取請求之前運行,並且應全部通過。 應新增其他測試與新程式碼。 若要執行測試,請導覽至目 …/places-scripts/import/ 錄,然後在 python ./places_import.py 終端機中輸入。

本頁內容