Show Menu
トピック×

POIのバルクアップロード

Web Service APIを使用して.csvファイルからPOIデータベースへのPOIのバッチインポートを簡単にするPythonスクリプトのセットが作成されました。 これらのスクリプトは、このオープンソース gitレポートからダウンロードできま す。
これらのスクリプトを実行する前に、WebサービスAPIにアクセスする場合は、統合の概要と前提 条件の「ユーザーアクセスの前提条件 を参照してください
スクリプトに関する情報を次に示します。

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 Service UIマップ内のPOIの位置を表すピンのカラーとして使用されます。
    • 有効な値は、「」、「#3E76D0」、「#AA99E8」、「#DC2ABA」、「#FC685B」、「#FC962E」、「#F6C436」、「#BECE5D」、「#61B56B」です。b、#3DC8DE、および""
    • この値を空白のままにすると、Places Service UIではデフォルトの色として青が使用されます。
      値は、青(#3E76D0)、紫(#AA99E8)、フスキア(#DC2ABA)、オレンジ(#FC685B)、淡いオレンジ(#FC962E)、黄(#F6C436)、明(#BECE5D)、緑(#61B56B)、薄い青(#3DC8DE)のそれぞれに対応しています。
  • アイコン。Places Service UIマップ上のPOIの場所を表すピン上のアイコンとして使用されます。
    • 有効値は、「」、ショップ、ホテルベッド、車、飛行機、電車、船、スタジアム、アムゼントパーク、アンカー、ベル、ベル、入札、書き物、ブラウズ、ブラシ、ビル、カメラ、時計、教育、懐中電灯、ゲーム、女性、男性、ハンマー、ハート、ホーム、打ち上げ、電球、郵便受け、金、ピン、買い物かごstar、target、teapot、thumbDown、thumbUp、trap、trophy、rench。
      アイコンの値は、次の図に示す順序で表示されます。
    • 値を空白のままにすると、UIはデフォルトのアイコンとして星を使用します。
  • 言及されていない列は空白にできます。

スクリプトの実行

  1. gitリポジトリからローカル ディレクトリに 、ファイルをダウンロードします。
  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 し、 ( return )キーを押します。

インポート前のCSVチェック

スクリプトは、最初に.csvファイルに対して次のチェックを完了します。
  • ファイルが指定さ .csv れたかどうか。
  • ファイルパスが有効かどうか。
  • 予約済みのメタデータヘッダを含めるかどうか。
    予約済みのメタデータヘッダーは、lib_id、名前、説明、タイプ、経度、緯度、半径、国、都道府県、市区町村、街路、カテゴリ、アイコン、色です。
    ヘッダーはすべて小文字で、任意の順序で表示できます。
  • CSVファイルセクションで指定された列の値を検証します。
エラーが見つかった場合、スクリプトはエラーを出力し、中止します。 エラーが見つからない場合、スクリプトはPOIを1000バッチで読み込もうとします。 バッチが正常に読み込まれると、スクリプトはステータスコード200をレポートします。 バッチが正常に読み込まれなかった場合は、エラーが報告されます。

単体テスト

単体テストはファイル内にあ tests.py り、各プル要求の前に実行し、すべてが合格する必要があります。 新しいコードを使用して、テストを追加する必要があります。 テストを実行するには、ディレクトリ …/places-scripts/import/ に移動し、ターミナルに python ./places_import.py 入力します。