Show Menu
SUJETS×

Bulk upload of POIs

Le bouton Importer les points d’intérêt du service Lieux permet de télécharger en masse les nouveaux points d’intérêt à l’aide d’un fichier CSV. Un exemple de modèle de feuille de calcul est fourni pour indiquer les colonnes de données requises et comment ajouter des métadonnées personnalisées facultatives.
Cette vidéo présente le processus d'importation en masse et de modification en masse :

Scripts d'API Python

Un ensemble de scripts Python a été créé pour simplifier l'importation par lots des points d'intérêt à partir d'un fichier .csv dans une base de données POI à l'aide des API de service Web. Ces scripts peuvent être téléchargés à partir de ce git repo open source.
Avant d’exécuter ces scripts, pour accéder aux API des services Web, voir Conditions préalables à l’accès des utilisateurs dans la section Présentation de l’ intégration et conditions préalables .
Voici quelques informations sur les scripts :
Ces informations sont également incluses dans un fichier lisez-moi dans le référentiel git .

Fichier CSV

Un exemple de fichier .csv places_sample.csv fait partie de ce package et comprend les en-têtes requis et une ligne d’exemples de données. Ces en-têtes sont tous en minuscules et correspondent aux clés de métadonnées réservées utilisées dans la base de données Places. Les colonnes que vous ajoutez au fichier .csv sont ajoutées à la base de données du point d’accès (POI) dans une section de métadonnées distincte pour chaque point d’accès (POI) en tant que paires clé/valeur et la valeur d’en-tête est utilisée comme clé.
Voici une liste des colonnes et des valeurs que vous devez utiliser :
  • lib_id
    Identifiant de bibliothèque valide obtenu à partir de la base de données d’API.
  • type
    Le point est actuellement la seule valeur valide.
  • longitude
    Valeur comprise entre -180 et 180.
  • latitude
    Valeur comprise entre -85 et 85.
  • radius
    Valeur comprise entre 10 et 20 000.

Valeurs de colonne

Les valeurs des colonnes suivantes sont utilisées dans l’interface utilisateur du service Lieux :
  • color, qui est utilisée comme couleur de la broche qui représente l’emplacement du point d’accès dans la carte d’interface utilisateur du service Places.
    • Les valeurs valides sont "", #3E76D0, #AA99E8, #DC2ABA, #FC685B, #FC962E, #F6C436, #BECE5D, #61B56B, #3DC8DE et "".
    • Si la valeur n’est pas renseignée, l’interface utilisateur du service Lieux utilise le bleu comme couleur par défaut.
      Les valeurs correspondent au bleu (#3E76D0), au violet (#AA99E8), au fuschia (#DC2ABA), à l’orange (#FC685B), à l’orange clair (#FC962E), au jaune (#F6C436), au vert clair (#BECE5D), au vert (#61B1B). 56B), et bleu clair (#3DC8DE), respectivement.
  • qui sert d’icône sur la broche représentant l’emplacement de la POI sur la carte d’interface utilisateur du service Places.
    • Les valeurs valides sont "", boutique, hotelbed, voiture, avion, train, navire, stade, stade, parc d'attraction, ancrage, beaker, bell, bid, livre, boîte, mallette, navigateur, brosse, bâtiment, calculatrice, caméra, horloge, éducation, lampe de poche, suivre, jeu, femme, homme, cadeau, marteau, coeur, maison, clé, lancement, ampoule, boîte aux lettres, épingle, promouvoir, ruban, shoppingCart, étoile, cible, théière, pouceDown, pouceUp, piège, trophée, clé à molette.
      Les valeurs d’icône sont répertoriées dans l’ordre dans lequel elles apparaissent dans l’illustration suivante :
    • Si la valeur n’est pas renseignée, l’interface utilisateur utilise l’étoile comme icône par défaut.
  • Les colonnes qui ne sont pas mentionnées peuvent rester vides.

Exécution du script

  1. Téléchargez des fichiers depuis le référentiel places-scripts git vers votre répertoire local.
  2. Dans un éditeur de texte, ouvrez le config.py fichier et remplissez les tâches suivantes :
    a. Modifiez les valeurs de variable suivantes en tant que chaînes :
    • csv_file_path
      Il s'agit du chemin d'accès à votre .csv fichier.
    • access_code
      Il s'agit de votre code d'accès obtenu à partir de l'appel à l'Adobe IMS. Pour plus d’informations sur la façon d’obtenir ce code d’accès, voir Conditions préalables à l’accès des utilisateurs dans Présentation de l’ intégration et Conditions préalables .
    • org_id
      orgID Experience Cloud dans lequel les points d’intérêt doivent être importés. Pour plus d’informations sur la manière d’obtenir l’ID d’organisation, voir Conditions préalables pour l’accès des utilisateurs dans Présentation de l’ intégration et Conditions préalables .
    • api_key
      Il s'agit de votre clé d'API REST Places obtenue à partir de votre intégration de lieux d'E/S Adobe. Pour plus d’informations sur la façon d’obtenir la clé d’API, voir Conditions préalables à l’accès des utilisateurs dans Présentation de l’ intégration et Conditions préalables . b. Enregistrez vos modifications.
  3. Dans une fenêtre de terminal, accédez au …/places-scripts/import/ répertoire.
  4. Saisissez python ./places_import.py et appuyez sur la enter touche ( return ).

Vérifications CSV préalables à l’importation

Le script effectue initialement les vérifications suivantes sur le fichier .csv :
  • Indique si un .csv fichier a été spécifié.
  • Indique si le chemin d’accès au fichier est valide.
  • Précise si les en-têtes de métadonnées réservés sont inclus.
    Les en-têtes de métadonnées réservés sont lib_id, name, description, type, longitude, latitude, rayon, pays, état, ville, rue, catégorie, icône et couleur.
    Les en-têtes sont tous en minuscules et peuvent être répertoriés dans n’importe quel ordre.
  • Vérifie les valeurs des colonnes spécifiées dans la section de fichier CSV.
Si des erreurs sont détectées, le script imprime les erreurs et est abandonné. Si aucune erreur n’est détectée, le script tente d’importer les points d’intérêt par lots de 1 000. Si le lot est importé avec succès, le script signale un code d’état de 200. Si l’importation du lot échoue, des erreurs sont signalées.

Tests unitaires

Les tests unitaires sont dans le tests.py fichier, doivent être exécutés avant chaque demande d'extraction et doivent tous être exécutés. Des tests supplémentaires doivent être ajoutés avec un nouveau code. Pour exécuter les tests, accédez au …/places-scripts/import/ répertoire, puis entrez python ./places_import.py dans le terminal.