ArcGIS Maps SDK for JavaScript: Novedades de la versión 5.0
Nota: ArcGIS Maps SDK for JavaScript ahora utiliza versiones semánticas, lo que facilita la comprensión de los cambios, la evaluación del impacto de las actualizaciones y la planificación de actualizaciones con confianza.
¡Bienvenidos a la primera versión 5! Repleta de emocionantes mejoras, desde un potente asistente de IA hasta un sitio de documentación rediseñado, esta versión lleva la experiencia al siguiente nivel.
¡Sumérgete en lo más destacado de la versión 5.0 y descubre las novedades!
Componentes de IA (beta) para aplicaciones web de mapeo de agentes
Crea aplicaciones de mapeo web con agentes que utilicen una interfaz de lenguaje natural con nuestro nuevo paquete de componentes de IA (beta) . Los usuarios pueden explorar y analizar información geográfica mediante indicaciones conversacionales, lo que ofrece una experiencia más sencilla y accesible.
Explora la producción de trigo en la aplicación de mapeo de Agentic con ArcGIS-Assistant
Este paquete contiene el componente asistente y los agentes:
Componente asistente : <arcgis-assistant> proporciona a los usuarios finales una interfaz de chat que les permite interactuar con un mapa web utilizando lenguaje natural a través de uno o más agentes.
Agentes : procesan las entradas del usuario y generan respuestas apropiadas según su funcionalidad.
- Agente de navegación: para navegar a una parte específica del mapa, respondiendo a las preguntas de " Dónde ". Ejemplos de indicaciones: "Ve al puente Golden Gate", "Ampliar".
- Agente de exploración de datos: para consultar y filtrar características, calcular estadísticas y proximidad espacial: las preguntas de tipo "¿ Qué?" . Por ejemplo, "¿Cuál es la ciudad más poblada?" y "¿Cuántas ciudades hay a menos de 48 kilómetros del río Colorado?" se pueden responder con un mapa que contenga las capas correspondientes.
- Agente de ayuda: para asistencia y orientación contextual, como "¿Qué tipo de preguntas puedo hacer?", "¿Qué capas hay en este mapa?"
- Agentes personalizados : los desarrolladores pueden crear agentes personalizados para el componente Asistente para gestionar tareas, flujos de trabajo o necesidades de datos únicos.
Para utilizar el asistente y los agentes de IA, solo se requieren unas pocas líneas de código:
<arcgis-assistant reference-element="#wheat-map">
<arcgis-assistant-navigation-agent></arcgis-assistant-navigation-agent>
<arcgis-assistant-data-exploration-agent></arcgis-assistant-data-exploration-agent>
<arcgis-assistant-help-agent></arcgis-assistant-help-agent>
</arcgis-assistant>
<arcgis-map id="wheat-map" item-id="dd6e8957e7a94765bf32bc07097cbf46"></arcgis-map>
Para obtener más información sobre cómo crear aplicaciones de mapeo de agentes con componentes de IA, consulta nuestra página de guía , prueba los componentes y déjanos saber tus comentarios durante el período beta.
Dibujar y editar curvas reales
Dibujo de curvas reales con Sketch: Los usuarios ahora pueden crear geometrías con segmentos de curva mientras dibujan, utilizando nuevas herramientas como curvas Bézier, segmentos de arco y segmentos de arco de punto final, lo que facilita la construcción de arcos Bézier y circulares. Los segmentos de línea recta existentes se pueden convertir en arcos circulares arrastrando el controlador del punto medio mientras se mantiene presionada la tecla Mayús.
Dibujo basado en segmentos: cambie sin problemas entre herramientas de dibujo (línea, mano alzada y nuevas opciones de curva) mientras crea segmentos de geometría en polilíneas o polígonos.
Utiliza la herramienta de curva Bézier y línea recta para dibujos complejos
Las nuevas herramientas de dibujo de curvas están integradas en los componentes Sketch y Editor y en el modelo de vista de boceto de forma nativa.
Crea, edita y ajusta a entidades con curvas en el Editor: el componente Editor ahora admite agregar y actualizar entidades con curvas reales, así como ajustar a cualquier punto a lo largo de un segmento de curva, lo que permite una edición de curvas fácil y segura dentro de su capa de entidades.
Nota: la compatibilidad con curvas y el cambio de herramientas solo se admiten en 2D.
Ilumina escenas 3D con símbolos que emiten luz y brillan.
Los materiales emisivos hacen que los símbolos emitan luz, lo que permite escenas nocturnas realistas, además de realzar la imagen y mejorar la legibilidad. Cualquier símbolo volumétrico puede convertirse en un elemento emisor de luz, ideal para resaltar elementos temáticos. Para una representación nocturna realista, aplica la información emisiva directamente a modelos 3D, como rótulos o ventanas iluminadas, para crear una atmósfera natural.
El efecto de brillo realza todos los emisores con una apariencia suave y luminosa y un aspecto más estilizado en toda la escena.
Capa de salpicadura gaussiana
Presentamos la Capa de Salpicadura Gaussiana , un nuevo tipo de capa 3D que proporciona una visualización fotorrealista de entornos naturales y construidos complejos en una escena 3D. Ofrece un renderizado de alto nivel de detalle para estructuras delgadas e intrincadas, como líneas eléctricas, barandillas, antenas y vegetación densa, además de una transparencia suave para materiales como el vidrio y otras superficies semitranslúcidas. Estas mejoras son compatibles con flujos de trabajo avanzados como la inspección, el análisis de vegetación y los flujos de trabajo de presentación de alta fidelidad.
La capa de salpicadura gaussiana es ideal para áreas con alto nivel de detalle, ofreciendo imágenes realistas. La capa de malla integrada proporciona datos de alta precisión, editables y medibles. Juntos, los tipos de capas 3D permiten a los desarrolladores crear experiencias 3D interactivas, inmersivas y contextualizadas en la web.
La capa de salpicadura gaussiana es ideal para áreas con mucho detalle y ofrece imágenes realistas.
Mejoras en la tabla de características
Editar con restricciones de valores de atributos contingentes: el componente Tabla de características ahora respeta las restricciones de valores de atributos contingentes al editar celdas, lo que garantiza la integridad de los datos y actualizaciones de atributos válidas en la tabla.
Guardado automático de cambios durante la edición en la tabla de características: Los desarrolladores pueden desactivar el guardado automático durante la edición para verificar las actualizaciones antes de guardar los cambios. El guardado automático sigue activado por defecto.
Experiencia de visualización de archivos adjuntos mejorada: ahora puede ver información adicional del archivo, como nombre, tipo de archivo adjunto, tamaño y palabras clave al ver los archivos adjuntos en la tabla.
Creación de aplicaciones con componentes
Este lanzamiento marca oficialmente una evolución emocionante: ¡de widgets a componentes!
Los componentes son la forma recomendada de crear aplicaciones, ya que ofrecen una productividad maximizada y una integración fluida con frameworks modernos. Si bien todos los widgets están obsoletos en la versión 5.0 , sus aplicaciones basadas en widgets seguirán funcionando correctamente. Los widgets ya no recibirán nuevas funciones y su eliminación está prevista para el primer trimestre de 2027 (versión 6.0). ¡Explore nuestra guía de migración , patrones de programación actualizados, tutoriales y ejemplos de componentes listos para usar para empezar a crear la próxima generación de aplicaciones!
Nuevos componentes: esta versión incluye muchos componentes nuevos, comenzando con el componente de análisis de seguimiento de red de servicios públicos para una experiencia de seguimiento mejorada y optimizada y el componente de medición de volumen (beta) para agregar este análisis de forma declarativa.
Nuevas opciones de estilo: la visualScalepropiedad se añade a los componentes seleccionados para facilitar el ajuste de tamaño. Se ha añadido una nueva variable CSS llamada "<sup>" para actualizar el color del contorno del foco en las vistas de mapa y escena. --arcgis-view-color-focus
Componentes basados en análisis: Los componentes Perfil de Elevación, Proyección de Sombras y Medición de Volumen (beta) ahora utilizan el objeto de análisis correspondiente, lo que mejora la estabilidad y la consistencia. Los objetos de análisis también están disponibles en la API principal como reemplazo de los modelos de vista.
Paquetes de componentes comunes : El nuevo paquete de componentes comunes contiene un conjunto de componentes de interfaz de usuario, incluyendo los componentes Slider, Histograma y Ticks. Son ideales para la visualización cuantitativa con o sin mapa.
Componentes de gráficos : Ahora puedes crear gráficos de calor en el Visor de mapas y cargarlos en aplicaciones web personalizadas desde la capa, ampliando así las opciones programáticas mediante el modelo de gráficos publicado en la versión 4.34. Además, la representación de saltos de clase es compatible con los gráficos de calor para visualizar datos en distintos rangos.
Mejoras en las etiquetas
Gestión mejorada de la oclusión para etiquetas e iconos en 3D : Las etiquetas e iconos ahora se reconocen en escenas 3D incluso con oclusión parcial o total, lo que proporciona mejor contexto, orientación y percepción espacial. Incorporamos la nueva propiedad occludedVisibility para configurar la visibilidad, que incluye tres modos:
- Adaptable (predeterminado): Las etiquetas e iconos que se encuentran detrás de otros objetos se renderizan según su distancia detrás de un objeto. Este modo se utiliza en mapas base 3D.
- Visible: las etiquetas y los íconos detrás de otros objetos siempre se muestran.
- Oculto: Las etiquetas e iconos detrás de otros objetos no se representan. Esto coincide con el comportamiento de versiones anteriores del SDK.
Reposicionamiento automático de etiquetas para polígonos en 2D : las etiquetas dentro de los polígonos se reposicionan automáticamente cuando el centroide del polígono está fuera del área visible del mapa 2D, de modo que las etiquetas permanecen visibles y brindan un mejor contexto a medida que navega por el mapa.
Arrastra y suelta puntos de referencia en el componente Direcciones
El componente Indicaciones ahora permite a los usuarios ajustar rutas con puntos de referencia con la clásica función de arrastrar y soltar. Los puntos de referencia son lugares por los que las rutas pasan obligatoriamente, pero no es necesario detenerse. Utiliza el botón "Editar ruta" para añadir, mover y eliminar puntos de referencia.
Agrega y edita puntos de referencia de forma interactiva con el componente Direcciones
Mejoras de imágenes orientadas
La interfaz del componente Visor de Imágenes Orientadas se ha rediseñado para ofrecer una experiencia de usuario más intuitiva y optimizada. También hemos añadido una nueva herramienta de búsqueda para facilitar el acceso a las imágenes, un mejor almacenamiento en caché de imágenes para un mejor rendimiento y un filtrado de información temporal para una consulta precisa de imágenes según las restricciones temporales.
Interfaz de usuario renovada y nuevas funciones en el Visor de imágenes orientadas
Sincronización de la selección a través del Administrador de selección
La nueva clase Administrador de Selección (beta) proporciona a los desarrolladores acceso a las entidades seleccionadas en capas y tablas, tanto en mapas 2D como en escenas 3D. El administrador de selección puede configurarse para detectar modificaciones en las capas seleccionables y actualizar automáticamente las selecciones en respuesta, lo que proporciona una forma centralizada de gestionar el estado de la selección dentro de una vista.
Uso del mapa base basado en sesiones
Los desarrolladores de ArcGIS Location Platform pueden usar la nueva API de sesión de mapas base para consumir mapas base por sesión, un periodo durante el cual un solo usuario de una sola aplicación puede acceder a un número ilimitado de teselas de mapas base desde el servicio de mapas base. Esto puede ayudar a los desarrolladores a predecir el coste del uso de mapas base. Explora el modelo de uso en acción con este tutorial .
Mejoras en la documentación y programación
Nueva experiencia de búsqueda y visualización de muestras : Puedes explorar la lista de muestras con nuestro diseño y experiencia de búsqueda mejorados. También hemos añadido nuevos diseños a las muestras para que la descripción completa, el código y la ventana de vista previa estén disponibles simultáneamente, lo que facilita la edición del código en tiempo real mientras se lee la descripción. Además, la mayoría de las muestras se han actualizado para usar componentes que reflejan los patrones de uso recomendados y las mejores prácticas.
Diseños de aplicaciones de mapas : Una nueva guía presenta patrones recomendados para estructurar aplicaciones de mapas web, diseñadas para construir con Calcite Design System y el SDK de JavaScript Maps. Tres nuevos ejemplos enfocados en el diseño están disponibles en la sección " Aplicaciones de diseño" , diseñados para facilitar el desarrollo de la interfaz de usuario.
Introducción a @arcgis/create: La guía de introducción se ha actualizado con instrucciones para crear una aplicación con npm usando la herramienta CLI de @arcgis/create y plantillas de inicio. Ahora puede crear una aplicación lista para usar con un simple comando:npx @arcgis/create -n my-arcgis-app -t vite
Etiqueta de script única para usuarios de CDN : Use una sola etiqueta de script en aplicaciones basadas en CDN para acceder a la API principal, componentes de mapas, componentes de IA, componentes comunes, componentes de gráficos, componentes de codificación y componentes de Calcite simultáneamente sin aumentar significativamente el tamaño. Tenga en cuenta que type="module"es obligatorio.
<!-- Load the ArcGIS Maps SDK for JavaScript from CDN -->
<script type="module" src="https://js.arcgis.com/5.0/"></script>
Esto reemplaza la estructura de etiquetas de script de varias líneas, lo que facilita la carga del SDK y la creación de aplicaciones pequeñas. El comportamiento anterior sigue siendo accesible mediante<script type="module" src="https://js.arcgis.com/5.0/core.js"></script>
Cambios en la importación de TypeScript y codemod : Para los desarrolladores de TypeScript, recomendamos el uso de importaciones ESM individuales para importar tipos directamente desde sus respectivos archivos de módulo. El espacio de nombres __esri anterior ya no es compatible. Se proporciona un codemod para actualizar automáticamente a las importaciones ESM recomendadas para una migración sencilla.
Documentación para versiones anteriores: a partir de la versión 4.34, la documentación del SDK anterior para las versiones compatibles estará disponible en nuestro sitio web, lo que facilitará el acceso exacto a lo que necesita sin tener que descargar el SDK localmente.
¿Migrando desde Google? Nuevas páginas de guía diseñadas para ayudar a los desarrolladores de la API de JavaScript de Google Maps a migrar al SDK de ArcGIS Maps para JavaScript. Incluyen configuración, tutoriales para flujos de trabajo comunes, conceptos y una matriz terminológica para facilitar la transición técnica.
Más información
La versión 5.0 ofrece más que las características mencionadas anteriormente. Disfruta de transiciones de renderizado de flujo más fluidas, renderizado de suelo transparente mejorado y mucho más. Descubre la lista completa de actualizaciones en nuestras notas de la versión .
Únete a nuestra transmisión en vivo de YouTube el miércoles 15 de abril a las 9:00 a . m. (hora del Pacífico) . Esta sesión interactiva y relajada le brinda la oportunidad de explorar las últimas actualizaciones y obtener respuestas a sus preguntas directamente del equipo de producto.
¡La Cumbre anual de Desarrolladores y Tecnología de Esri regresa a Palm Springs en marzo! Conoce a los equipos que impulsan la tecnología de desarrollo web de Esri, comparte tus innovaciones y adquiere nuevas perspectivas. Nos complace ofrecer una serie de presentaciones técnicas con los últimos avances, mejores prácticas y técnicas, y ejemplos inspiradores.
Yixuan "Emily" Hu es una entusiasta de la cartografía y la tecnología, y trabaja como gerente de producto para las tecnologías de desarrollo web de Esri. Anteriormente, trabajó como ingeniera de software para aplicaciones de cartografía web y desarrolladora de SIG en el sector inmobiliario comercial, con formación en SIG y análisis espacial urbano. Emily se dedica a aprovechar su experiencia en diferentes áreas de la industria SIG y su trayectoria global para ayudar a los clientes a desarrollar las aplicaciones más adecuadas.