Version

Using Geographic Symbol Series

Purpose

This topic provides information on how to use the GeographicSymbolSeries element in the XamGeographicMap™ control.

Required background

The following table lists the topics required as a prerequisite to understanding this topic.

Topic Purpose

This topic provides information on how to add the XamGeographicMap control to an application page.

This topic provides information about layout of map elements in the XamGeographicMap control.

This topic provides resources with information about maps, shape files, and geo-spatial related material. Use these resources to learn about and obtain geo-spatial shape files as well as tools for their editing.

This topic provides information on how to bind shape files with geo-spatial data to the XamGeographicMap control.

This topic provides information about supported types of geographic series in the XamGeographicMap control.

In this topic

This topic contains the following sections:

Geographic Symbol Series

Overview

In the XamGeographicMap control, the GeographicSymbolSeries is a visual map element that displays geo-spatial data using points or markers in a geographic context. This type of geographic series is often used to render a collection of geographic locations such as cities, airports, earthquakes, or points of interests.

Preview

The following is a preview of the XamGeographicMap control with GeographicSymbolSeries plotting locations of major cities in the world.

GeographicMap Using Geographic Symbol Series 1.png

Data Requirements

Similarly to other types of geographic series in the XamGeographicMap control, the GeographicSymbolSeries has the ItemsSource property for the purpose of data binding. This property can be bound to an object that implements the IEnumerable interface (e.g. List, Collection, Queue, Stack). In addition, each item in this object must have two numeric data columns that store a geographic location (longitude and latitude). These data columns are then mapped to the LatitudeMemberPath and LongitudeMemberPath properties. The GeographicSymbolSeries uses values of these mapped data columns to plot symbol elements in the XamGeographicMap control.

Example

The following code shows how to bind the GeographicSymbolSeries to locations of cities loaded from a shape file using the ShapefileConverter.

In XAML:

<ig:ShapefileConverter x:Key="shapefileConverter"
                        ShapefileSource="ShapeFiles/world_cities.shp"
                        DatabaseSource="ShapeFiles/world_cities.dbf" >
</ig:ShapefileConverter>
<ig:XamGeographicMap x:Name="GeoMap">
    <ig:XamGeographicMap.Series>
        <ig:GeographicSymbolSeries ItemsSource="{StaticResource shapefileConverter}"
                                   LongitudeMemberPath="Points[0][0].X"
                                   LatitudeMemberPath="Points[0][0].Y">
        </ig:GeographicSymbolSeries>
    </ig:XamGeographicMap.Series>
</ig:XamGeographicMap>

In Visual Basic:

' create and set data binding to the GeographicSymbolSeries
Dim geoSeries = New GeographicSymbolSeries()
geoSeries.ItemsSource = shapefileConverter
geoSeries.LongitudeMemberPath = "Points[0][0].X"
geoSeries.LatitudeMemberPath = "Points[0][0].Y"
' add the GeographicSymbolSeries to the the XamGeographicMap
Me.GeoMap.Series.Add(geoSeries)

In C#:

// create and set data binding to the GeographicSymbolSeries
var geoSeries = new GeographicSymbolSeries();
geoSeries.ItemsSource = shapefileConverter;
geoSeries.LongitudeMemberPath = "Points[0][0].X";
geoSeries.LatitudeMemberPath = "Points[0][0].Y";
// add the GeographicSymbolSeries to the the XamGeographicMap
this.GeoMap.Series.Add(geoSeries);

Related Content

The following topics provide additional information related to this topic.

Topic Purpose

This topic provides information on how to add the XamGeographicMap control to an application page.

This topic provides information about layout of map elements in the XamGeographicMap control.

This topic provides resources with information about maps, shape files, and geo-spatial related material. Use these resources to learn about and obtain geo-spatial shape files as well as tools for their editing.

This topic provides information on how to bind shape files with geo-spatial data to the XamGeographicMap control.

This topic provides information about supported types of geographic series in the XamGeographicMap control.