DocumentazioneMobile SDKGuida di Places Service

Caricamento in blocco di POI bulk-upload-pois

Last update: Wed May 24 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Il Importa POI nel servizio Places può essere utilizzato per caricare in blocco nuovi POI utilizzando un file CSV. Viene fornito un modello di foglio di calcolo di esempio per mostrare quali colonne di dati sono necessarie e come aggiungere metadati personalizzati facoltativi.

Schermata Importazione in blocco

Guarda questo video che mostra il processo di importazione e modifica in blocco:

Importazione in blocco e modifica dei punti di interesse di Places Service

Script API Python

È stato creato un set di script Python per semplificare l’importazione batch di POI da un file .csv a un database POI utilizzando le API dei servizi Web. Questi script possono essere scaricati da questo open source archivio git.

Prima di eseguire questi script, per accedere alle API dei servizi Web, vedi Prerequisiti per l’accesso degli utenti in Panoramica sull’integrazione e prerequisiti.

Seguono alcune informazioni sugli script:

TIP
Queste informazioni sono incluse anche in un file readme nel archivio git.

file .CSV

Un esempio di file .csv places_sample.csv, fa parte di questo pacchetto e include le intestazioni richieste e una riga di dati di esempio. Queste intestazioni sono tutte minuscole e corrispondono alle chiavi di metadati riservate utilizzate nel database Places. Le colonne aggiunte al file .csv verranno aggiunte al database POI in una sezione di metadati separata per ciascun POI come coppie chiave/valore e il valore dell’intestazione viene utilizzato come chiave.

Elenco delle colonne e dei valori da utilizzare:

  • lib_id

    Un ID libreria valido ottenuto dal database POI.

  • type

    Punto è attualmente l'unico valore valido.

  • longitude

    Un valore compreso tra -180 e 180.

  • latitude

    Un valore compreso tra -85 e 85.

  • radius

    Un valore compreso tra 10 e 20.000.

Valori colonna

Nell’interfaccia utente di Places Service vengono utilizzati i valori delle seguenti colonne:

  • color, che viene utilizzato come colore del pin che rappresenta la posizione del POI nella mappa dell’interfaccia utente di Places Service.

    • I valori validi sono "", #3E76D0, #AA99E8, #DC2ABA, #FC685B, #FC962E, #F6C436, #BECE5D, #61B56B e #3DC8DE e "".

    • Se il valore viene lasciato vuoto, l’interfaccia utente di Places Service utilizza il blu come colore predefinito.

      I valori corrispondono rispettivamente a blu (#3E76D0), viola (#AA99E8), fuschia (#DC2ABA), arancione (#FC685B), arancione chiaro (#FC962E), giallo (#F6C436), verde chiaro (#BECE5D), verde (#61B56B) e blu chiaro (#3DC8DE).

  • che viene utilizzata come icona sul pin che rappresenta la posizione del POI sulla mappa dell’interfaccia utente di Places Service.

    • I valori validi sono: "", shop, hotelbed, car, airplane, train, ship, stadium, amusementpark, anchor, beaker, bell, bid, book, box, Sincronia file, browse, brush, building, calcolatrice, fotocamera, orologio, istruzione, torcia elettrica, follow, game, femmina, maschio, regalo, martello, cuore, casa, key, launch, lightbulb, mailbox, money, pin, promote, ribbon, shoppingCart, star, target, teiera, thumbDown, thumbUp, trap, trophy, wrench.

      I valori delle icone sono elencati nell'ordine in cui compaiono nella figura seguente:

      icone nell’interfaccia utente

    • Se il valore viene lasciato vuoto, l’interfaccia utente utilizza l’icona stella come icona predefinita.

  • Le colonne non menzionate possono essere lasciate vuote.

Esecuzione dello script

  1. Scaricare i file da archivio git nella directory locale.

  2. In un editor di testo, apri config.py e completare le seguenti attività:

    a. Modifica i seguenti valori delle variabili come stringhe:

    • csv_file_path

      Questo è il percorso del .csv file.

    • access_code

      Questo è il codice di accesso ottenuto dalla chiamata ad Adobe IMS. Per informazioni su come ottenere questo codice di accesso, vedi Prerequisiti per l’accesso degli utenti in Panoramica sull’integrazione e prerequisiti.

    • org_id

      L’orgID di Experience Cloud in cui i POI devono essere importati. Per informazioni su come ottenere l’ID organizzazione, consulta Prerequisiti per l’accesso degli utenti in Panoramica sull’integrazione e prerequisiti.

    • api_key

      Questa è la chiave API REST di Places ottenuta dall’integrazione di Adobe I/O Places. Per informazioni su come ottenere la chiave API, consulta Prerequisiti per l’accesso degli utenti in Panoramica sull’integrazione e prerequisiti.
      b. Salva le modifiche.

  3. In una finestra del terminale, passare alla …/places-scripts/import/ directory.

  4. Invio python ./places_import.py e premere il tasto Invio (return).

Controlli CSV pre-importazione

Lo script esegue inizialmente i seguenti controlli sul file .csv:

  • Se un .csv è stato specificato il file.

  • Indica se il percorso del file è valido.

  • Se sono incluse le intestazioni di metadati riservate.

    Le intestazioni di metadati riservate sono lib_id, name, description, type, longitude, latitude, radius, country, state, city, street, category, icon e color.

    note tip
    TIP
    Le intestazioni sono tutte minuscole e possono essere elencate in qualsiasi ordine.

  • Verifica i valori delle colonne specificate nella sezione del file CSV.

Se vengono rilevati errori, lo script stampa gli errori e viene interrotto. Se non vengono trovati errori, lo script tenta di importare i POI in batch di 1000. Se il batch viene importato correttamente, lo script riporta il codice di stato 200. Se il batch non viene importato correttamente, vengono segnalati errori.

Test di unità

Gli unit test sono nel tests.py , deve essere eseguito prima di ogni richiesta di pull e deve essere trasmesso tutto. È necessario aggiungere altri test con un nuovo codice. Per eseguire i test, passare alla …/places-scripts/import/ e immettere python ./places_import.py nel terminale.

recommendation-more-help
475fad96-f29f-4dca-a109-68bf0557e825