Mapa del área geográfica Blazor

En el componente de mapa Blazor, puede usar IgbGeographicScatterAreaSeries para dibujar una superficie coloreada, en un contexto geográfico, basada en una triangulación de datos de longitud y latitud con un valor numérico asignado a cada punto. Este tipo de serie geográfica es útil para representar datos dispersos, definidos por ubicaciones geográficas como la temperatura del tiempo, las precipitaciones, la distribución de la población, la contaminación del aire, etc.

Blazor Geographic Area Map Example

IgbGeographicScatterAreaSeries funciona de manera muy similar a IgbGeographicContourLineSeries excepto que representa datos como superficies interpoladas y coloreadas en lugar de líneas de contorno que conectan puntos de datos con los mismos valores.

Data Requirements

Al igual que otros tipos de series geográficas en el componente de mapa, IgbGeographicScatterAreaSeries tiene la propiedad DataSource que se puede vincular a una matriz de objetos. Además, cada elemento en el origen de elementos debe tener tres columnas de datos, dos que almacenan coordenadas geográficas de longitud y latitud y una columna de datos que almacena un valor asociado con la ubicación geográfica. Las propiedades LongitudeMemberPath, LatitudeMemberPath y ColorMemberPath de la serie geográfica identifican esta columna de datos. IgbGeographicScatterAreaSeries realiza automáticamente la triangulación de datos integrada en elementos en ItemsSource si no se establece ninguna triangulación en la propiedad TrianglesSource. Sin embargo, calcular la triangulación puede ser un proceso que consume mucho tiempo, por lo que el rendimiento en tiempo de ejecución será mejor al especificar un TriangulationSource para esta propiedad, especialmente cuando hay una gran cantidad de elementos de datos presentes.

Data Binding

La siguiente tabla resume las propiedades de GeographicScatterAreaSeries utilizadas para el enlace de datos.

Nombre de la propiedad	tipo de propiedad	Descripción
`DataSource`	cualquier	La fuente de elementos de datos sobre los que realizar la triangulación si el`TrianglesSource` La propiedad no proporciona datos de triangulación.
`LongitudeMemberPath`	cadena	El nombre de la propiedad que contiene la longitud de todos los elementos vinculados al`DataSource`.
`LatitudeMemberPath`	cadena	El nombre de la propiedad que contiene la latitud para todos los elementos vinculados al`DataSource`.
`ColorMemberPath`	cadena	El nombre de la propiedad que contiene un valor en las coordenadas de latitud y longitud de cada elemento de datos. Este valor numérico se convertirá a un color cuando el`ColorScale` La propiedad está establecida.
`TrianglesSource`	cualquier	La fuente de datos de triangulación. Estableciendo triángulos de la`TriangulationSource` Oponerse a esta propiedad mejora tanto el rendimiento en tiempo de ejecución como la representación de series geográficas.
`TriangleVertexMemberPath1`	cadena	El nombre de la propiedad del`TrianglesSource` elementos que, para cada triángulo, contienen el índice del primer punto de vértice en ItemsSource. No es obligatorio establecer esta propiedad. Se toma de forma predeterminada a menos que se proporcione una lógica de triangulación personalizada.
`TriangleVertexMemberPath2`	cadena	El nombre de la propiedad del`TrianglesSource` elementos que, para cada triángulo, contienen el índice del primer punto de vértice en ItemsSource. No es obligatorio establecer esta propiedad. Se toma de forma predeterminada a menos que se proporcione una lógica de triangulación personalizada.
`TriangleVertexMemberPath3`	cadena	El nombre de la propiedad del`TrianglesSource` elementos que, para cada triángulo, contienen el índice del primer punto de vértice en ItemsSource. No es obligatorio establecer esta propiedad. Se toma de forma predeterminada a menos que se proporcione una lógica de triangulación personalizada.

Color Scale

Utilice la propiedad ColorScale de IgbGeographicScatterAreaSeries para resolver los valores de colores de los puntos y así rellenar la superficie de la serie geográfica. Los colores se interpolan suavemente alrededor de la forma de la superficie aplicando un rasterizador de triángulos de píxeles a los datos de triangulación. Debido a que la representación de la superficie se realiza en píxeles, la escala de colores utiliza colores en lugar de pinceles. La clase IgbCustomPaletteColorScale proporcionada debería satisfacer la mayoría de las necesidades de coloración, pero la aplicación puede heredar la clase base ColorScale para una lógica de coloración personalizada.

La siguiente tabla enumera las propiedades de IgbCustomPaletteColorScale que afectan el color de la superficie de GeographicScatterAreaSeries.

Nombre de la propiedad	tipo de propiedad	Descripción
`Palette`	Colección observable	Obtiene o establece la colección de colores para seleccionar o interpolar.
`InterpolationMode`	`ColorScaleInterpolationMode`	Obtiene o establece el método para obtener un color de la Paleta.
`MaximumValue`	doble	El valor más alto para asignar un color. Cualquier valor dado mayor que este valor será transparente.
`MinimumValue`	doble	El valor más bajo para asignar un color. Cualquier valor dado menor que este valor será transparente.

Code Snippet

El siguiente código muestra cómo vincular IgbGeographicScatterAreaSeries a datos de triangulación que representan las temperaturas de la superficie en el mundo.

@using IgniteUI.Blazor.Controls


<IgbGeographicMap Height="100%" Width="100%" Zoomable="true">
    <IgbGeographicScatterAreaSeries LongitudeMemberPath="Lon"
        LatitudeMemberPath="Lat"
        ColorMemberPath="Value"
        ColorScale="ColorScale"
        DataSource="Data">
    </IgbGeographicScatterAreaSeries>
</IgbGeographicMap>

@code {

    private List<Location> Data;
    private CustomPaletteColorScale ColorScale;

    protected override void OnInitialized()
    {
        var brushes = "";
        brushes += "rgba(32, 146, 252, 0.5) "; // semi-transparent blue
        brushes += "rgba(14, 194, 14, 0.5) ";  // semi-transparent green
        brushes += "rgba(252, 120, 32, 0.5) "; // semi-transparent orange
        brushes += "rgba(252, 32, 32, 0.5) ";  // semi-transparent red

        this.ColorScale = new CustomPaletteColorScale();
        this.ColorScale.Palette = brushes;
        this.ColorScale.MinimumValue = 0;
        this.ColorScale.MaximumValue = 30;

        this.Data = WorldTemperatures.Load();
    }
}