GeoJsonDataSource

new GeoJsonDataSource

A DataSource which processes both GeoJSON and TopoJSON data. Since GeoJSON has no standard for styling content, we provide default graphics via the defaultPoint, defaultLine, and defaultPolygon properties. Any changes to these objects will affect the resulting DynamicObject collection.

Parameters:

Name	Type	Argument	Description
`name`	String	<optional>	The name of this data source. If undefined, a name will be taken from the name of the GeoJSON file.

Example

//Use a billboard instead of a point.
var dataSource = new Cesium.GeoJsonDataSource();
var defaultPoint = dataSource.defaulPoint;
defaultPoint.point = undefined;
var billboard = new Cesium.DynamicBillboard();
billboard.image = new Cesium.ConstantProperty('image.png');
defaultPoint.billboard = billboard;
dataSource.loadUrl('sample.geojson');

See:

Source:

onDataSource.js

Members

changedEvent :Event

Gets an event that will be raised when the underlying data changes.

clock :DynamicClock

GeoJSON only defines static data, therefore this property is always undefined.

defaultLine :DynamicObject

Gets or sets the default graphics to be applied to GeoJSON LineString and MultiLineString geometries.

defaultPoint :DynamicObject

Gets or sets the default graphics to be applied to GeoJSON Point and MultiPoint geometries.

defaultPolygon :DynamicObject

Gets or sets the default graphics to be applied to GeoJSON Polygon and MultiPolygon geometries.

dynamicObjects :DynamicObjectCollection

Gets the collection of DynamicObject instances.

errorEvent :Event

Gets an event that will be raised if an error is encountered during processing.

isLoading :Boolean

Gets a value indicating if the data source is currently loading data.

loadingEvent :Event

Gets an event that will be raised when the data source either starts or stops loading.

name :String

Gets a human-readable name for this instance.

<static> crsLinkHrefs :Object

An object that maps the href property of a crs link to a callback function which takes the crs properties object and returns a Promise that resolves to a function that takes a GeoJSON coordinate and transforms it into a WGS84 Earth-fixed Cartesian. Items in this object take precedence over those defined in crsLinkHrefs, assuming the link has a type specified.

<static> crsLinkTypes :Object

An object that maps the type property of a crs link to a callback function which takes the crs properties object and returns a Promise that resolves to a function that takes a GeoJSON coordinate and transforms it into a WGS84 Earth-fixed Cartesian. Items in crsLinkHrefs take precedence over this object.

<static> crsNames :Object

An object that maps the name of a crs to a callback function which takes a GeoJSON coordinate and transforms it into a WGS84 Earth-fixed Cartesian. Older versions of GeoJSON which supported the EPSG type can be added to this list as well, by specifying the complete EPSG name, for example 'EPSG:4326'.

Methods

<static> prototype.load

Asynchronously loads the provided GeoJSON object, replacing any existing data.

Parameters:

Name	Type	Argument	Description
`geoJson`	Object		The object to be processed.
`sourceUri`	String	<optional>	The base URI of any relative links in the geoJson object.

Throws:

DeveloperError : Unsupported GeoJSON object type.
RuntimeError : crs is null.
RuntimeError : crs.properties is undefined.
RuntimeError : Unknown crs name.
RuntimeError : Unable to resolve crs link.
RuntimeError : Unknown crs type.

Returns:

Promise a promise that will resolve when the GeoJSON is loaded.

<static> prototype.loadUrl

Asynchronously loads the GeoJSON at the provided url, replacing any existing data.

Parameters:

Name	Type	Description
`url`	Object	The url to be processed.

Returns:

Promise a promise that will resolve when the GeoJSON is loaded.