Finnish Address Autocomplete: configuración y ayuda

• Sugerencias para Finlandia y Åland. Búsqueda Digitransit en cuenta y pedido nativos, incluidos invitados.
• Campos juntos. Calle y número, código de cinco cifras y localidad del resultado.
• Letras conservadas. Escalera como 5 A; apartamentos ausentes requieren entrada manual.
• Administración. Ayuda en Clientes > Direcciones y ventanas nativas de dirección.
• Uso diario. Pantalla táctil, teclado y lectores de pantalla; sigue la entrada manual.
• Tu clave. Módulo gratuito, cuatro interruptores y clave Digitransit por tienda.

• Clave de suscripción de Digitransit: La clave principal de tu suscripción a Digitransit developer API (portal-api.digitransit.fi, Profile > Subscriptions).
• Sugerir direcciones mientras el cliente escribe: interruptor general, después de la clave.
• 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 Gestor de módulos > Configurar o la entrada Finnish Address del menú del back office. Una página contiene Configuración, Integridad, Licencia, Actualización y Soporte. Orden visible: clave Digitransit, los cuatro interruptores anteriores y Guardar. Los cuatro están activados por defecto. La clave tiene 32 caracteres hexadecimales; un campo vacío la elimina y desactiva este servicio en los formularios. No hay selector de países. En multitienda elige una tienda que puedas gestionar; ajustes y clave se guardan por tienda. Siguen notas de cobertura, cuenta, entrada manual, privacidad y CSP, luego la nota de módulos relacionados. Hay texto inglés y traducciones alemana, francesa, polaca, italiana, española y finlandesa. No hay ajustes en sueco; las peticiones usan lang=fi para Finlandia (FI) y lang=sv para Åland (AX), independientemente del idioma de la página.

Usar para estos países pertenece a los módulos mundiales. Una lista vacía significa todos los países disponibles en el formulario; una selección limita ese servicio. Finnish Address tiene cobertura fija de Finlandia (FI) y Åland (AX) sin selector de países. Los formularios de Åland (AX) reciben sugerencias en sueco, como Torggatan 1, 22100 Mariehamn. El código postal determina el país tanto de las direcciones como de las calles: 22xxx identifica Åland. Los formularios FI y AX solo reciben resultados de su país; se descartan las filas sin código postal válido. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantén todos actualizados. Los destinos BAN franceses están separados de Finlandia y Åland. Una búsqueda fallida no cambia automáticamente de servicio.

Permite Digitransit en tu política de seguridad del contenido

El origen externo identificado en el código es https://api.digitransit.fi en connect-src. Scripts y estilos se sirven desde la tienda; no se cargan SDK, fuentes ni mapas externos Digitransit. Une este ejemplo a tu política existente, manteniendo reglas del tema, inline/nonces y otros módulos. Con French Address Autocomplete permite también https://data.geopf.fr en connect-src. El enlace al portal sirve para configurar y no lo carga el autocompletado.

script-src 'self';
style-src 'self';
connect-src 'self' https://api.digitransit.fi;

Conserva piso y detalles de entrega

País elegido, segunda línea, nombre, empresa y teléfono no cambian. Mantén apartamento, buzón, planta y entrada en la segunda línea. Un número de apartamento reconocido tras una letra de escalera debe coincidir con el resultado; en caso contrario, no se ofrece sugerencia. Elegir solo una calle vacía el código postal; completa número y código a mano. Revisa toda la dirección antes de guardar. Puedes seguir escribiendo y editando manualmente.

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. Finlandia o Åland deben estar disponibles; activa los países donde entregas.
• Comprueba que Finlandia o Åland estén activas y disponibles en los formularios nativos de dirección que uses.

Usar para estos países pertenece a los módulos mundiales. Una lista vacía significa todos los países disponibles en el formulario; una selección limita ese servicio. Finnish Address tiene cobertura fija de Finlandia (FI) y Åland (AX) sin selector de países. Los formularios de Åland (AX) reciben sugerencias en sueco, como Torggatan 1, 22100 Mariehamn. El código postal determina el país tanto de las direcciones como de las calles: 22xxx identifica Åland. Los formularios FI y AX solo reciben resultados de su país; se descartan las filas sin código postal válido. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantén todos actualizados. Los destinos BAN franceses están separados de Finlandia y Åland. Una búsqueda fallida no cambia automáticamente de servicio.

El filtro comprueba el número de casa, la letra de escalera y el número de apartamento reconocidos. Una letra sola tras el número puede interpretarse brevemente como escalera al escribir la localidad. Un número de apartamento reconocido sin coincidencia oculta la lista. Formularios, temas, rutas de nuevo pedido y versiones mezcladas necesitan pruebas.

Las sugerencias empiezan tras tres caracteres y una pausa de 300 ms. El navegador envía un GET directo a https://api.digitransit.fi/geocoding/v1/autocomplete con layers=address%2Cstreet, size=10, lang=fi para Finlandia (FI) o lang=sv para Åland (AX), text y digitransit-subscription-key. El adaptador separa una letra unida al número, elimina códigos postales aislados de cinco cifras y agrupa espacios. La consulta original sigue filtrando los resultados localmente. Se muestran como máximo cinco opciones válidas y distintas. Las direcciones tienen prioridad sobre las calles. El número de casa, la letra de escalera y el número de apartamento reconocidos deben coincidir con el resultado. Los prefijos de palabras y números parciales reducen la lista; no se garantiza un resultado.

Si el servicio tarda, tras 600 ms aparece la línea sencilla «Buscando direcciones…». La petición termina tras diez segundos. El cliente puede continuar introduciendo la dirección manualmente.

Campos de la dirección elegida

La selección mantiene la calle y el número devueltos, como Mannerheimintie 10 o Hämeenkatu 5 A. La letra de escalera A permanece si existe, al igual que una letra unida al número como 81a. El código postal conserva cinco cifras, incluidos los ceros iniciales de 00100. La localidad procede de locality, con localadmin como alternativa. En los formularios de Åland, Maarianhamina se escribe como Mariehamn. No se convierte el nombre de la localidad a mayúsculas. País elegido, segunda línea, nombre, empresa y teléfono no cambian. Mantén apartamento, buzón, planta y entrada en la segunda línea. Un número de apartamento reconocido tras una letra de escalera debe coincidir con el resultado; en caso contrario, no se ofrece sugerencia. Elegir solo una calle vacía el código postal; completa número y código a mano. Revisa toda la dirección antes de guardar. Puedes seguir escribiendo y editando manualmente.

Usar para estos países pertenece a los módulos mundiales. Una lista vacía significa todos los países disponibles en el formulario; una selección limita ese servicio. Finnish Address tiene cobertura fija de Finlandia (FI) y Åland (AX) sin selector de países. Los formularios de Åland (AX) reciben sugerencias en sueco, como Torggatan 1, 22100 Mariehamn. El código postal determina el país tanto de las direcciones como de las calles: 22xxx identifica Åland. Los formularios FI y AX solo reciben resultados de su país; se descartan las filas sin código postal válido. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantén todos actualizados. Los destinos BAN franceses están separados de Finlandia y Åland. Una búsqueda fallida no cambia automáticamente de servicio.

En Clientes > Direcciones el equipo puede elegir una dirección de Finlandia o Åland 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 © OpenStreetMap contributors, © Digitransit 2026. 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 texto preparado, layers=address,street, size=10, lang=fi para Finlandia (FI) o lang=sv para Åland (AX) y tu clave como parámetros URL a https://api.digitransit.fi. No añade parámetros separados de nombre, email, teléfono, empresa, segunda línea o país. El contenido de búsqueda puede transmitirse. Visitantes y servicio ven la clave. Las credenciales del navegador están desactivadas; la conexión expone la IP y puede enviar datos del navegador (cabeceras Origin y Referer) según su política. La selección no pide detalles. El diagnóstico omite texto, claves, URL y respuestas; PrestaShop guarda la dirección. Menciónalo en tu política de privacidad. Atribución: © OpenStreetMap contributors, © Digitransit YEAR, con el año del servidor.

• Cobertura: Finlandia y Åland, las direcciones de OpenStreetMap servidas por el geocodificador Digitransit (Fintraffic y HSL): muy buena en las ciudades, faltan algunas direcciones rurales. Las sugerencias empiezan en cuanto se guarda la clave de suscripción. No se prometen datos completos, actuales, orden concreto ni uso gratuito ilimitado. El resultado registrado Itäinen Rantakatu 2 tiene dos códigos postales: revisa la selección.
• Una dirección exige código postal de cinco cifras y localidad. Se descartan filas incompletas, erróneas y duplicadas. Sin dirección válida ni número reconocido puede aparecer una calle sola. Elegirla vacía el código postal; completa número y código manualmente. No se ha demostrado cobertura específica de apartamentos, buzones o lugares sin calle con nombre.
• Sin clave no hay peticiones; los permisos del servicio pueden fallar con 401/403. Una respuesta 429 pausa según Retry-After o diez segundos. Errores de red, respuesta o tiempo dejan la entrada manual. No hay cambio automático de servicio.
• El filtro comprueba el número de casa, la letra de escalera y el número de apartamento reconocidos. Una letra sola tras el número puede interpretarse brevemente como escalera al escribir la localidad. Un número de apartamento reconocido sin coincidencia oculta la lista. Formularios, temas, rutas de nuevo pedido y versiones mezcladas necesitan pruebas.
• Sin mapa, geolocalización, almacenamiento de coordenadas, validación al enviar, selección automática del país o garantía de entrega. Módulo gratuito con actualizaciones de por vida y sin compromiso de soporte incluido. Condiciones, cuotas y uso de clave en navegador requieren verificación actual.

• Sin resultados para Finlandia o Åland: comprueba que Finlandia o Åland estén activas y revisa los interruptores y escribe calle completa, número y localidad. Clave de suscripción de Digitransit: 32 caracteres hexadecimales; 401/403.
• Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.
• Solo calle o sin resultado: completa número, código postal y localidad postal a mano y revisa la dirección antes de guardar.
• Servicio indisponible: revisa red/CSP Digitransit, 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.