new GeoJsonDataSource(name)
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.
Name | Type | 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:
Members
-
staticGeoJsonDataSource.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. -
staticGeoJsonDataSource.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. -
staticGeoJsonDataSource.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'.
-
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.
Methods
-
load(geoJson, sourceUri) → Promise
-
Asynchronously loads the provided GeoJSON object, replacing any existing data.
Name Type Description geoJson
Object The object to be processed. sourceUri
String optional The base URI of any relative links in the geoJson object. Returns:
a promise that will resolve when the GeoJSON is loaded.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.
-
-
loadUrl(url) → Promise
-
Asynchronously loads the GeoJSON at the provided url, replacing any existing data.
Name Type Description url
Object The url to be processed. Returns:
a promise that will resolve when the GeoJSON is loaded.