(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:

  1. true: muestra la información de actualización de la capa.
  2. 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
)