A
DataSource which processes both
GeoJSON and TopoJSON data.
simplestyle-spec properties will also be used if they
are present.
| 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:
var viewer = new Cesium.Viewer('cesiumContainer');
viewer.dataSources.add(Cesium.GeoJsonDataSource.load('../../SampleData/ne_10m_us_states.topojson', {
stroke: Cesium.Color.HOTPINK,
fill: Cesium.Color.PINK,
strokeWidth: 3,
markerSymbol: '?'
}));Demo:
Members
-
Gets or sets default of whether to clamp to the ground.
-
Default Value:
false -
Gets 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. -
Gets 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
crsLinkHrefstake precedence over this object. -
Gets 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'.
-
staticCesium.GeoJsonDataSource.fill : Color
-
Gets or sets default color for polygon interiors.
-
Default Value:
Color.YELLOW -
staticCesium.GeoJsonDataSource.markerColor : Color
-
Gets or sets the default color of the map pin created for each point.
-
Default Value:
Color.ROYALBLUE -
Gets or sets the default size of the map pin created for each point, in pixels.
-
Default Value:
48 -
Gets or sets the default symbol of the map pin created for each point. This can be any valid Maki identifier, any single character, or blank if no symbol is to be used.
-
staticCesium.GeoJsonDataSource.stroke : Color
-
Gets or sets the default color of polylines and polygon outlines.
-
Default Value:
Color.BLACK -
Gets or sets the default width of polylines and polygon outlines.
-
Default Value:
2.0 -
changedEvent : Event
-
Gets an event that will be raised when the underlying data changes.
-
This DataSource only defines static data, therefore this property is always undefined.
-
clustering : EntityCluster
-
Gets or sets the clustering options for this data source. This object can be shared between multiple data sources.
-
Gets the collection of
Entityinstances. -
errorEvent : Event
-
Gets an event that will be raised if an error is encountered during processing.
-
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.
-
Gets or sets a human-readable name for this instance.
-
Gets whether or not this data source should be displayed.
Methods
-
staticCesium.GeoJsonDataSource.load(data, options) → Promise.<GeoJsonDataSource>
-
Creates a Promise to a new instance loaded with the provided GeoJSON or TopoJSON data.
Name Type Description dataResource | String | Object A url, GeoJSON object, or TopoJSON object to be loaded. optionsObject optional An object with the following properties: Name Type Default Description sourceUriString optional Overrides the url to use for resolving relative links. markerSizeNumber GeoJsonDataSource.markerSizeoptional The default size of the map pin created for each point, in pixels. markerSymbolString GeoJsonDataSource.markerSymboloptional The default symbol of the map pin created for each point. markerColorColor GeoJsonDataSource.markerColoroptional The default color of the map pin created for each point. strokeColor GeoJsonDataSource.strokeoptional The default color of polylines and polygon outlines. strokeWidthNumber GeoJsonDataSource.strokeWidthoptional The default width of polylines and polygon outlines. fillColor GeoJsonDataSource.filloptional The default color for polygon interiors. clampToGroundBoolean GeoJsonDataSource.clampToGroundoptional true if we want the geometry features (polygons or linestrings) clamped to the ground. If true, lines will use corridors so use Entity.corridor instead of Entity.polyline. Returns:
A promise that will resolve when the data is loaded. -
load(data, options) → Promise.<GeoJsonDataSource>
-
Asynchronously loads the provided GeoJSON or TopoJSON data, replacing any existing data.
Name Type Description dataResource | String | Object A url, GeoJSON object, or TopoJSON object to be loaded. optionsObject optional An object with the following properties: Name Type Default Description sourceUriString optional Overrides the url to use for resolving relative links. describeGeoJsonDataSource~describe GeoJsonDataSource.defaultDescribePropertyoptional A function which returns a Property object (or just a string), which converts the properties into an html description. markerSizeNumber GeoJsonDataSource.markerSizeoptional The default size of the map pin created for each point, in pixels. markerSymbolString GeoJsonDataSource.markerSymboloptional The default symbol of the map pin created for each point. markerColorColor GeoJsonDataSource.markerColoroptional The default color of the map pin created for each point. strokeColor GeoJsonDataSource.strokeoptional The default color of polylines and polygon outlines. strokeWidthNumber GeoJsonDataSource.strokeWidthoptional The default width of polylines and polygon outlines. fillColor GeoJsonDataSource.filloptional The default color for polygon interiors. clampToGroundBoolean GeoJsonDataSource.clampToGroundoptional true if we want the features clamped to the ground. Returns:
a promise that will resolve when the GeoJSON is loaded.