Luxembourg Address Autocomplete: configuración y ayuda

• Sugerencias para Luxemburgo. Datos oficiales geoportail.lu del registro nacional en cuenta y pedido nativos, incluidos invitados.
• Campos rellenados juntos. Número antes de calle, código postal de cuatro cifras sin L- y localidad recibida.
• Cobertura fija de Luxemburgo. Direcciones numeradas del registro; palabras y números comprobados antes de mostrarlas.
• Administración. Ayuda para el equipo en Clientes > Direcciones.
• Entrada cotidiana. Toques, teclado y avisos para lectores de pantalla; entrada manual disponible.
• Sin cuenta del servicio. Módulo y datos nacionales gratuitos, cuatro interruptores y sin clave.

• Sugerir direcciones mientras el cliente escribe: interruptor general, primero en el formulario.
• En el formulario de dirección de la cuenta de cliente: direcciones nativas de cuenta.
• En los formularios de dirección del pedido (incluidos invitados y direcciones de facturación separadas): invitados y direcciones de factura separadas incluidos.
• En el formulario de dirección del back office (direcciones de clientes, pedidos nuevos): direcciones de clientes y nuevos pedidos nativos.

Abre Configurar en el Gestor de módulos o la entrada Luxembourg Address del menú del back office. La página única tiene Configuración, Integridad, Licencia, Actualización y Soporte. Los cuatro interruptores aparecen en ese orden, seguidos de Guardar. Todos están activos de inicio. No hay campo de clave, cuenta o país del servicio. En multitienda elige una tienda que puedas gestionar; los ajustes se guardan para esa tienda. Tras el formulario aparecen notas de cobertura/servicio gratuito, entrada manual, privacidad, CSP y otros servicios de direcciones. Hay textos de ajustes en inglés, alemán, francés, polaco, italiano y español, con el texto fuente inglés como alternativa. Alemán y francés están disponibles; no se incluye archivo luxemburgués. Esto no promete datos de direcciones traducidos.

Usar para estos países solo aparece en módulos mundiales. Vacío significa todos los países del formulario; una lista limita ese módulo. geoportail.lu permanece fijo en LU. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. Puedes dejar un servicio mundial para los demás destinos y activar Luxembourg Address para Luxemburgo. Un error no relanza automáticamente otra búsqueda en otro servicio.

Permite geoportail.lu en tu Content Security Policy

Origen externo deducido del código: https://map.geoportail.lu en connect-src. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. No se carga SDK ni hoja de estilos externa geoportail.lu. Combina el ejemplo con tu política y conserva reglas del tema, inline/nonces y otros módulos. Con French Address Autocomplete permite también https://data.geopf.fr en connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://map.geoportail.lu;

Conserva piso y detalles de entrega

País, segunda línea, nombre, empresa y teléfono quedan intactos. Conserva piso, planta o entrada en la segunda línea. Comprueba número antes de calle, código postal y localidad antes de guardar. El cliente puede editar el resultado o escribir todo a mano. Una unidad solo se conserva en la primera línea si forma parte de un número recibido que el adaptador admite; no hay búsqueda separada de pisos.

Requisitos

• Rango general PrestaShop: PS 1.6 – 9.x. Mínimo exacto declarado: PrestaShop 1.6.1.0 y PHP desde 7.1.
• Campos nativos y presentación Bootstrap 3, 4 o 5. Luxemburgo debe estar disponible; actívalo si entregas allí.
• Comprueba que Luxemburgo esté activo y disponible en los formularios nativos de dirección que uses.

Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. Luxembourg Address funciona solo.

Instalar no certifica disponibilidad ni todas las combinaciones de plataforma y tema. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.

Las sugerencias empiezan tras tres caracteres y 300 ms de pausa. El navegador envía un GET directo a https://map.geoportail.lu/fulltextsearch, con limit=10, layer=Adresse y el texto sin espacios exteriores en query. Muestra hasta cinco resultados distintos coincidentes. Cada palabra escrita debe iniciar una palabra de la dirección; los números se verifican con el número de casa, sus intervalos/partes con barra, números del nombre de calle o código postal. Un prefijo del código exige coincidencia de número de casa; L-8008 se reconoce al filtrar. El texto enviado no cambia de otra forma.

Si el servicio va lento, tras 600 ms aparece la línea sencilla «Buscando direcciones…» (texto original inglés: «Searching addresses…»). Después de diez segundos la petición termina; puedes seguir escribiendo la dirección a mano.

Campos de la dirección elegida

El adaptador lee etiquetas <número>, <calle/localidad>, L-<NNNN> <localidad>. address1 mantiene número antes de calle, postcode guarda cuatro cifras sin L-, y city conserva la localidad recibida. Ejemplo: 11, Avenue de la Gare / 1611 Luxembourg. Letras, intervalos y partes con barra aceptadas quedan en la primera línea; no se extrae campo separado de buzón, piso o edificio. Un buzón escrito debe coincidir con un elemento de la línea. Una localidad numerada podría encajar, pero las grabaciones no prueban un ejemplo sin calles. Se descartan etiquetas incorrectas y calles solas. Dos líneas: número y calle, luego código + localidad. Elegir no necesita otra consulta ni aporta provincia.

Usar para estos países solo aparece en módulos mundiales. Vacío significa todos los países del formulario; una lista limita ese módulo. geoportail.lu permanece fijo en LU. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. Puedes dejar un servicio mundial para los demás destinos y activar Luxembourg Address para Luxemburgo. Un error no relanza automáticamente otra búsqueda en otro servicio.

En Clientes > Direcciones el equipo puede elegir una dirección luxemburguesa después de una consulta telefónica para rellenar calle, código postal y localidad. El interruptor de administración es independiente de cuenta y pedido.

El código también contempla las ventanas nativas de dirección de un nuevo pedido servidas por la página de direcciones de clientes. Las rutas y formularios propios necesitan una prueba. El motor compartido admite formularios de dirección marcados por un módulo integrador como Checkout Revolution. Ambos módulos comparten los mismos ajustes del servicio por tienda.

En el móvil toca un resultado bajo la calle. Con teclado, las flechas recorren la lista y Enter elige; Escape o Tab la cierra. Los lectores de pantalla reciben avisos de resultados. El componente compartido sigue la presentación Bootstrap del tema.

La atribución visible es © ACT Luxembourg. Si no hay coincidencias la lista queda cerrada, y se anuncia la indisponibilidad del servicio. Puedes escribir y editar a mano. Guardar nunca exige una sugerencia ni valida la posibilidad de entrega.

Privacidad y crédito de los datos

El navegador envía el texto buscado sin espacios exteriores en query, con limit=10 y layer=Adresse, directamente a geoportail.lu en https://map.geoportail.lu. No añade parámetros de clave, país, idioma, nombre, correo, teléfono, empresa ni segunda línea. Todo lo escrito en la búsqueda se transmite. La conexión expone IP y puede enviar datos del navegador (cabeceras Origin y Referer) según las reglas del navegador. Las credenciales están desactivadas. Cada petición termina tras diez segundos; la entrada manual sigue disponible. Elegir no envía una segunda petición. No hay historial ni proxy de tienda; el diagnóstico del motor omite consultas y direcciones recibidas. PrestaShop guarda la dirección normalmente. Describe la transferencia en tu política de privacidad. Crédito visible: © ACT Luxembourg.

• Cobertura y disponibilidad dependen de geoportail.lu. No se promete cada dirección, servicio permanente ni uso ilimitado.
• Un resultado requiere línea numerada, código postal de cuatro cifras y localidad en el formato esperado. Se descartan formas desconocidas y resultados aproximados sin coincidencia de palabras/números. Solo se filtran diez filas recibidas, así que puede faltar una dirección válida. Sin alternativa de solo calle, unidad inventada ni ejemplo sin calles demostrado. Completa y comprueba la dirección a mano si hace falta.
• Una respuesta 429 pausa peticiones según Retry-After o diez segundos. Entrada manual disponible, sin servicio alternativo automático.
• Formularios/temas propios y rutas distintas del nuevo pedido necesitan pruebas. Los formularios de pedido personalizados necesitan una integración con el motor compartido.
• Sin mapa, geolocalización, coordenadas guardadas, validación al enviar, selección automática del país ni garantía de entrega. Actualizaciones de por vida sin promesa de soporte incluido.

• Sin resultados luxemburgueses: comprueba que Luxemburgo esté activo y revisa los interruptores y escribe calle completa, número y localidad.
• Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.
• Sin resultado coincidente: prueba calle completa, número y localidad. Usa Avenue en lugar de Rue para el ejemplo; el filtro descarta aproximaciones que no coinciden. Escribe y comprueba la dirección a mano si hace falta.
• Servicio indisponible: revisa red/CSP geoportail.lu, espera tras un límite y sigue manualmente.
• Formulario o diseño propio: prueba formulario nativo, teclado/móvil y ruta de pedido; comprueba los ajustes del servicio compartidos por tienda.