DocumentazioneMobile SDKGuida di Places Service

Caricamento in blocco di POI bulk-upload-pois

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Il pulsante 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 di importazione in blocco

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

Importazione in blocco di Places Service e modifica POI

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 archivio Git open source.

Prima di eseguire questi script, per accedere alle API dei servizi Web, vedere Prerequisiti per l'accesso utente in Panoramica dell'integrazione e prerequisiti.

Seguono alcune informazioni sugli script:

TIP
Queste informazioni sono incluse anche in un file readme nell'archivio Git.

File CSV

Un file .csv di esempio, 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 nellinterfaccia 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. Scarica i file dall'archivio Git nella directory locale.

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

    a. Modifica i seguenti valori delle variabili come stringhe:

    • csv_file_path

      Percorso del file .csv.

    • access_code

      Questo è il codice di accesso ottenuto dalla chiamata ad Adobe IMS. Per informazioni su come ottenere questo codice di accesso, vedere Prerequisiti per l'accesso utente in Panoramica dell'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, vedere Prerequisiti per l'accesso utente in Panoramica dell'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, vedere Prerequisiti per l'accesso utente in Panoramica dell'integrazione e prerequisiti.

    b. Salva le modifiche.

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

  4. Immetti python ./places_import.py e premi la chiave enter (return).

Controlli CSV pre-importazione

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

  • Specifica di un file .csv.

  • 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 si trovano nel file tests.py, devono essere eseguiti prima di ogni richiesta di pull e devono essere tutti superati. È necessario aggiungere altri test con un nuovo codice. Per eseguire i test, passare alla directory …/places-scripts/import/ e immettere python ./places_import.py nel terminale.

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