Carga masiva de puntos de interés bulk-upload-pois
El botón Importar puntos de interés del servicio Places se puede usar para cargar nuevos puntos de interés de forma masiva mediante un archivo CSV. Se proporciona una plantilla de hoja de cálculo de ejemplo para mostrar qué columnas de datos son necesarias y cómo agregar metadatos personalizados opcionales.
Consulte este vídeo que muestra el proceso de importación y edición por lotes:
Importación y edición masiva de servicios de Places
Scripts de API de Python
Se ha creado un conjunto de scripts en Python para simplificar la importación por lotes de puntos de interés desde un archivo .csv a una base de datos de puntos de interés mediante las API de servicio web. Estos scripts se pueden descargar de este repositorio de código abierto git.
Antes de ejecutar estos scripts, para acceder a las API del servicio web, consulta Requisitos previos para el acceso de usuarios en Resumen general y requisitos previos de la integración.
A continuación se proporciona información sobre los scripts:
Archivo CSV
Un archivo .csv de ejemplo, places_sample.csv, forma parte de este paquete e incluye los encabezados necesarios y una fila de datos de ejemplo. Todos estos encabezados están en minúsculas y corresponden a las claves de metadatos reservadas que se utilizan en la base de datos de Places. Las columnas que agregue al archivo .csv se agregarán a la base de datos de puntos de interés en una sección de metadatos independiente para cada punto de interés como pares clave/valor, y el valor del encabezado se utilizará como clave.
Esta es una lista de las columnas y los valores que debe utilizar:
-
lib_idID de biblioteca válido obtenido de la base de datos de puntos de interés.
-
typePoint es actualmente el único valor válido.
-
longitudeUn valor entre -180 y 180.
-
latitudeUn valor entre -85 y 85.
-
radiusUn valor entre 10 y 20 000.
Valores de columna
Los valores de las siguientes columnas se utilizan en la interfaz de usuario del servicio de Places:
-
color, que se utiliza como el color del pin que representa la ubicación del punto de interés en el mapa de la interfaz de usuario del servicio de Places.
-
Los valores válidos son "", #3E76D0, #AA99E8, #DC2ABA, #FC685B, #FC962E, #F6C436, #BECE5D, #61B56B y #3DC8DE, y "".
-
Si se deja en blanco, la interfaz de usuario del servicio de Places utiliza el azul como color predeterminado.
Los valores corresponden a azul (#3E76D0), púrpura (#AA99E8), fucsia (#DC2ABA), naranja (#FC685B), naranja claro (#FC962E), amarillo (#F6C436), verde claro (#BECE5D), verde (#61B56B) y azul claro (#3DC8DE), respectivamente.
-
-
, que se utiliza como icono en el pin que representa la ubicación del punto de interés en el mapa de la interfaz de usuario del servicio de Places.
-
Los valores válidos son "", tienda, cama de hotel, coche, avión, tren, barco, estadio, parque de atracciones, ancla, vaso de precipitados, campana, oferta, libro, caja, maletín, examinar, pincel, edificio, calculadora, cámara, reloj, educación, linterna, seguir, juego, mujer, hombre, regalo, martillo, corazón, hogar, llave, lanzamiento, bombilla, buzón, dinero, pin, promover, cinta, carro de compras, estrella, objetivo, tetera, thumbDown, thumbUp, trampa, trofeo, llave inglesa.
Los valores de icono se muestran en el orden en que aparecen en la siguiente ilustración:
-
Si se deja en blanco, la interfaz de usuario utiliza asterisco como icono predeterminado.
-
-
Las columnas que no se mencionan pueden dejarse en blanco.
Ejecución del script
-
Descargue los archivos del repositorio git a su directorio local.
-
En un editor de texto, abra el archivo
config.pyy complete las tareas siguientes:a. Edite los siguientes valores de variables como cadenas:
-
csv_file_pathEsta es la ruta al archivo
.csv. -
access_codeEste es su código de acceso que se obtuvo de la llamada a Adobe IMS. Para obtener información sobre cómo obtener este código de acceso, consulte Requisitos previos para el acceso de usuarios en Información general y requisitos previos de la integración.
-
org_idEl orgID del Experience Cloud en el que se importarán los POI. Para obtener información sobre cómo obtener el identificador de organización, consulte Requisitos previos para el acceso de usuarios en Información general y requisitos previos de la integración.
-
api_keyEsta es la clave de API de REST de Places que se obtiene de la integración de Places de Adobe I/O. Para obtener información sobre cómo obtener la clave de API, consulte Requisitos previos para el acceso de usuarios en Información general y requisitos previos de la integración.
b. Guarde los cambios.
-
-
En una ventana de terminal, vaya al directorio
…/places-scripts/import/. -
Escriba
python ./places_import.pyy presione la tecla entrar (regresar).
Comprobaciones previas a la importación de CSV
La secuencia de comandos completa inicialmente las siguientes comprobaciones en el archivo .csv:
-
Si se especificó un archivo de
.csv. -
Indica si la ruta de archivo es válida.
-
Si se incluyen los encabezados de metadatos reservados.
Los encabezados de metadatos reservados son lib_id, nombre, descripción, tipo, longitud, latitud, radio, país, estado, ciudad, calle, categoría, icono y color.
note tip TIP Los encabezados están todos en minúsculas y se pueden enumerar en cualquier orden. -
Comprueba los valores de las columnas especificadas en la sección del archivo CSV.
Si se encuentran errores, la secuencia de comandos los imprime y se anula. Si no se encuentran errores, la secuencia de comandos intenta importar los puntos de interés en lotes de 1000. Si el lote se importa correctamente, el script informa de un código de estado de 200. Si el lote no se importa correctamente, se informa de los errores.
Pruebas unitarias
Las pruebas unitarias se encuentran en el archivo tests.py, deben ejecutarse antes de cada solicitud de extracción y deben aprobarse todas. Se deben añadir pruebas adicionales con el nuevo código. Para ejecutar las pruebas, vaya al directorio …/places-scripts/import/ e introduzca python ./places_import.py en el terminal.