(ES) updateLayer()
Información
Versión de implementación: beta 1.06
Descripción
Actualiza las propiedades de una capa de entidades.
Invocacion
updateLayer( layerName, uploadParam, newData, joinField, symbologyType, showUpdateInfo )
Parámetros de entrada
layerName
El nombre de la capa a partir del cual se seleccionará el dataSource. Este nombre corresponde con el nombre de la colección de entidades (featureCollection.name). Se introduce como una cadena de texto.
uploadParam
Parámetro que recoge la opción a actualizar. Se recibe como una cadena de texto, y de momento sólo acepta 'position'.
newData
Parámetro con la nueva información respecto a la que se cotejará la ya existente. Este parámetro debe corresponder con un FeatureCollection igual al usado para crear la capa original con el método de createLayer(). Acepta un objeto con la colección de entidades.
joinField
Corresponde con el nombre de la propiedad que interrelacionará la colección de entidades de los nuevos datos con las entidades de la capa. Dicha propiedad deberá encontrarse definida en 'entityProperties' o 'entityProperties.properties' de la entidad. Se introduce en el método como una cadena de texto.
symbologyType
Parámetro que indica el tipo de simbología que tiene la capa que se está actualizando. El valor introducido debe corresponder al valor utilizado a la hora de ejecutar el createLayer(). Se introduce como una cadena de texto, y de momento sólo acepta 'billboard'.
showUpdateInfo
Parámetro que muestra u oculta en la consola del navegador la información de actualización de la capa. Dicho parámetro se introduce como una cadena de texto, y puede ser:
- true: muestra la información de actualización de la capa.
- false: oculta la información de actualización de la capa.
Ejemplos de uso
Actualizar la posición de las entidades de una capa de nombre "realTimeBusData" y con simbología común a todas sus entidades, a partir de un objeto JSON llamado "newPositionsFeatureCollection" y en formato FeatureCollection, usando como nexo de unión entre los datos viejos y nuevos un campo llamado "codBus", mostrando en consola los datos actualizados.
updateLayer( 'realTimeBusData', 'position', newPositionsFeatureCollection, 'codBus', 'billboard', true )