The GeoRSSLayer class is used to create a layer based on GeoRSS. GeoRSS is a way to add geographic information to an RSS feed. The GeoRSSLayer supports both GeoRSS-Simple
and GeoRSS GML
encodings, and multiple geometry types.
It exports custom RSS tags as additional attribute fields in the form of simple strings or an array of JSON objects.
The GeoRSSLayer uses a utility service from ArcGIS.com. Therefore a GeoRSS file must be publicly accessible on the internet. If the GeoRSS files are behind the firewall you must to set the esriConfig.geoRSSServiceUrl to your own utility service (requires Portal for ArcGIS).
Known Limitations
Currently the GeoRSSLayer is not supported in SceneView.
Constructors
new GeoRSSLayer(properties)
properties Object See the properties for a list of all the properties that may be passed into the constructor. |
// Typical usage
esriConfig.geoRSSServiceUrl = "https://utility.arcgis.com/sharing/rss";
var layer = new GeoRSSLayer({
url: "https://www.disasterscharter.org/charter-portlets/cpi-mvc/activations/feed/rss/"
});
Property Overview
Name | Type | Summary | |
---|---|---|---|
String | The name of the class. more details | more details | |
String | The unique ID assigned to the layer. more details | more details | |
SimpleLineSymbol | Symbol used to represent line features from the GeoRSS feed. more details | more details | |
String | Indicates how the layer should display in the LayerList widget. more details | more details | |
Boolean | Indicates whether the layer's resources have loaded. more details | more details | |
Error | The Error object returned if an error occurred while loading. more details | more details | |
String | Represents the status of a load operation. more details | more details | |
Object[] | A list of warnings which occurred while loading. more details | more details | |
Number | The opacity of the layer. more details | more details | |
PictureMarkerSymbol | Symbol used to represent point features from the GeoRSS feed. more details | more details | |
SimpleFillSymbol | Symbol used to represent polygon features from the GeoRSS feed. more details | more details | |
String | The title of the layer used to identify it in places such as the Legend and LayerList widgets. more details | more details | |
String | For GeoRSSLayer the type is | more details | |
String | The URL pointing to a GeoRSS file. more details | more details | |
Boolean | Indicates if the layer is visible in the View. more details | more details |
Property Details
declaredClassStringreadonly
The name of the class. The declared class name is formatted as
esri.folder.className
.idString
The unique ID assigned to the layer. If not set by the developer, it is automatically generated when the layer is loaded.
lineSymbolSimpleLineSymbol
Symbol used to represent line features from the GeoRSS feed.
listModeString
Indicates how the layer should display in the LayerList widget. The known values are listed below.
Value Description show The layer is visible in the table of contents. hide The layer is hidden in the table of contents. hide-children If the layer is a GroupLayer, hide the children layers from the table of contents. Default Value: showloadedBooleanreadonly
Indicates whether the layer's resources have loaded. When
true
, all the properties of the object can be accessed.Default Value: falseloadErrorErrorreadonly
The Error object returned if an error occurred while loading.
Default Value: nullloadStatusStringreadonly
Represents the status of a load operation.
Value Description not-loaded The object's resources have not loaded. loading The object's resources are currently loading. loaded The object's resources have loaded without errors. failed The object's resources failed to load. See loadError for more details. Default Value: not-loadedloadWarningsObject[]readonly
A list of warnings which occurred while loading.
opacityNumber
The opacity of the layer. This value can range between
1
and0
, where0
is 100 percent transparent and1
is completely opaque.Default Value: 1Example:// Makes the layer 50% transparent layer.opacity = 0.5;
pointSymbolPictureMarkerSymbol
Symbol used to represent point features from the GeoRSS feed.
polygonSymbolSimpleFillSymbol
Symbol used to represent polygon features from the GeoRSS feed.
titleString
The title of the layer used to identify it in places such as the Legend and LayerList widgets.
When the layer is loaded from a portal item, the title of the portal item will be used. If a layer is loaded as part of a webmap or a webscene, then the title of the layer as stored in the webmap/webscene will be used.
typeStringreadonly
For GeoRSSLayer the type is
geo-rss
.urlString
The URL pointing to a GeoRSS file. This must be publically available.
visibleBoolean
Indicates if the layer is visible in the View. When
false
, the layer may still be added to a Map instance that is referenced in a view, but its features will not be visible in the view.Default Value: trueExample:// The layer is no longer visible in the view layer.visible = false;
Method Overview
Name | Return Type | Summary | |
---|---|---|---|
Promise | An instance of this class is a Promise. more details | more details | |
Cancels a load() operation if it is already in progress. more details | more details | ||
Boolean | Indicates whether there is an event listener on the instance that matches the provided event name. more details | more details | |
Boolean | An instance of this class is a Promise. more details | more details | |
Boolean | An instance of this class is a Promise. more details | more details | |
Boolean | An instance of this class is a Promise. more details | more details | |
Promise | Loads the resources referenced by this class. more details | more details | |
Object | Registers an event handler on the instance. more details | more details | |
Promise | An instance of this class is a Promise. more details | more details | |
Promise | An instance of this class is a Promise. more details | more details |
Method Details
An instance of this class is a Promise. Therefore
always()
may be used to execute a function if the promise is rejected or resolved. The input function will always execute no matter the response. For more information about promises, see the Working with Promises guide page.Parameter:optionalcallbackOrErrback FunctionThe function to execute when the promise is rejected or resolved.
Returns:Type Description Promise Returns a new promise for the result of callbackOrErrback
.Example:// Although this example uses MapView, any class instance that is a promise may use always() in the same way var view = new MapView(); view.always(function(){ // This function will always execute whether or not the promise is resolved or rejected });
cancelLoad()inherited
Cancels a load() operation if it is already in progress.
Indicates whether there is an event listener on the instance that matches the provided event name.
Parameter:type StringThe name of the event.
Returns:Type Description Boolean Returns true if the class supports the input event. An instance of this class is a Promise. Therefore
isFulfilled()
may be used to verify if the promise is fulfilled (either resolved or rejected). If it is fulfilled,true
will be returned. See the Working with Promises guide page for more information about promises.Returns:Type Description Boolean Indicates whether the promise has been fulfilled (either resolved or rejected). An instance of this class is a Promise. Therefore
isRejected()
may be used to verify if the promise is rejected. If it is rejected,true
will be returned. See the Working with Promises guide page for more information about promises.Returns:Type Description Boolean Indicates whether the promise has been rejected. An instance of this class is a Promise. Therefore
isResolved()
may be used to verify if the promise is resolved. If it is resolved,true
will be returned. See the Working with Promises guide page for more information about promises.Returns:Type Description Boolean Indicates whether the promise has been resolved. Loads the resources referenced by this class. This method automatically executes for a View and all of the resources it references in Map if the view is constructed with a map instance.
This method must be called by the developer when accessing a resource that will not be loaded in a View.
Returns:Type Description Promise Resolves when the resources have loaded. Registers an event handler on the instance. Call this method to hook an event with a listener. See the Events summary table for a list of listened events.
Parameters:type StringThe name of event to listen for.
listener FunctionThe function to call when the event is fired.
Returns:Type Description Object Returns an event handler with a remove()
method that can be called to stop listening for the event.Property Type Description remove Function When called, removes the listener from the event. - See also:
Example:view.on("click", function(event){ // event is the event handle returned after the event fires. console.log(event.mapPoint); });
An instance of this class is a Promise. Use
otherwise()
to call a function once the promise is rejected.Parameter:optionalerrback FunctionThe function to execute when the promise fails.
Returns:Type Description Promise Returns a new promise for the result of errback
.Example:// Although this example uses MapView, any class instance that is a promise may use otherwise() in the same way var view = new MapView(); view.otherwise(function(error){ // This function will execute if the promise is rejected due to an error });
An instance of this class is a Promise. Therefore
then()
may be leveraged once an instance of the class is created. This method takes two input parameters: acallback
function and anerrback
function. Thecallback
executes when the promise resolves (when the instance of the class loads). Theerrback
executes if the promise fails. See the Working with Promises guide page for additional details.Parameters:optionalcallback FunctionThe function to call when the promise resolves.
optionalerrback FunctionThe function to execute when the promise fails.
optionalprogback FunctionThe function to invoke when the promise emits a progress update.
Returns:Type Description Promise Returns a new promise for the result of callback
that may be used to chain additional functions.Example:// Although this example uses MapView, any class instance that is a promise may use then() in the same way var view = new MapView(); view.then(function(){ // This function will execute once the promise is resolved }, function(error){ // This function will execute if the promise is rejected due to an error });
Event Overview
Name | Type | Summary | |
---|---|---|---|
{view: View,layerView: LayerView} | Fires after the layer's LayerView is created and rendered in a view. more details | more details | |
{view: View,layerView: LayerView} | Fires after the layer's LayerView is destroyed and no longer renders in a view. more details | more details |
Event Details
layerview-createinherited
Fires after the layer's LayerView is created and rendered in a view.
- See also:
Properties:view ViewThe view in which the
layerView
was created.layerView LayerViewThe LayerView rendered in the view representing the layer in
layer
.Example:// This function will fire each time a layer view is created for this // particular view. layer.on("layerview-create", function(event){ // The LayerView for the layer that emitted this event event.layerView; });
layerview-destroyinherited
Fires after the layer's LayerView is destroyed and no longer renders in a view.