com.mapbox.mapboxsdk.style.sources

Class GeoJsonSource

java.lang.Object

com.mapbox.mapboxsdk.style.sources.Source

com.mapbox.mapboxsdk.style.sources.GeoJsonSource

public class GeoJsonSource
extends Source

GeoJson source, allows using FeatureCollections from Json.

See Also:

the style specification

Field Summary

Fields inherited from class com.mapbox.mapboxsdk.style.sources.Source

detached

Constructor Summary

Constructors

Constructor and Description
GeoJsonSource(java.lang.String id) Create an empty GeoJsonSource
GeoJsonSource(java.lang.String id, Feature feature) Create a GeoJsonSource from a Feature
GeoJsonSource(java.lang.String id, FeatureCollection features) Create a GeoJsonSource from a FeatureCollection.
GeoJsonSource(java.lang.String id, FeatureCollection features, GeoJsonOptions options) Create a GeoJsonSource from a FeatureCollection and non-default GeoJsonOptions.
GeoJsonSource(java.lang.String id, Feature feature, GeoJsonOptions options) Create a GeoJsonSource from a Feature and non-default GeoJsonOptions
GeoJsonSource(java.lang.String id, GeoJsonOptions options) Create an empty GeoJsonSource with non-default GeoJsonOptions.
GeoJsonSource(java.lang.String id, Geometry geometry) Create a GeoJsonSource from a Geometry
GeoJsonSource(java.lang.String id, Geometry geometry, GeoJsonOptions options) Create a GeoJsonSource from a Geometry and non-default GeoJsonOptions
GeoJsonSource(java.lang.String id, java.lang.String geoJson) Create a GeoJsonSource from a raw json string
GeoJsonSource(java.lang.String id, java.lang.String geoJson, GeoJsonOptions options) Create a GeoJsonSource from a raw json string and non-default GeoJsonOptions
GeoJsonSource(java.lang.String id, java.net.URL url) Create a GeoJsonSource from a remote geo json file
GeoJsonSource(java.lang.String id, java.net.URL url, GeoJsonOptions options) Create a GeoJsonSource from a remote geo json file and non-default GeoJsonOptions

Method Summary

Modifier and Type	Method and Description
protected void	finalize()
FeatureCollection	getClusterChildren(Feature cluster) Returns the children of a cluster (on the next zoom level) given its id (cluster_id value from feature properties).
int	getClusterExpansionZoom(Feature cluster) Returns the zoom on which the cluster expands into several children (useful for "click to zoom" feature) given the cluster's cluster_id (cluster_id value from feature properties).
FeatureCollection	getClusterLeaves(Feature cluster, long limit, long offset) Returns all the leaves of a cluster (given its cluster_id), with pagination support: limit is the number of leaves to return (set to Infinity for all points), and offset is the amount of points to skip (for pagination).
java.lang.String	getUrl()
protected void	initialize(java.lang.String layerId, java.lang.Object options)
protected java.lang.String	nativeGetUrl()
protected void	nativeSetUrl(java.lang.String url)
java.util.List<Feature>	querySourceFeatures(Expression filter) Queries the source for features.
void	setGeoJson(Feature feature) Updates the GeoJson with a single feature.
void	setGeoJson(FeatureCollection features) Updates the GeoJson.
void	setGeoJson(Geometry geometry) Updates the GeoJson with a single geometry.
void	setUrl(java.lang.String url) Updates the url
void	setUrl(java.net.URL url) Updates the url

Methods inherited from class com.mapbox.mapboxsdk.style.sources.Source

checkThread, getAttribution, getId, getNativePtr, nativeGetAttribution, nativeGetId, setDetached

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GeoJsonSource

public GeoJsonSource(java.lang.String id)

Create an empty GeoJsonSource

Parameters:

id - the source id

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     GeoJsonOptions options)

Create an empty GeoJsonSource with non-default GeoJsonOptions.

Parameters:

id - the source id

options - options

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     java.lang.String geoJson)

Create a GeoJsonSource from a raw json string

Parameters:

id - the source id

geoJson - raw Json FeatureCollection

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     java.lang.String geoJson,
                     GeoJsonOptions options)

Create a GeoJsonSource from a raw json string and non-default GeoJsonOptions

Parameters:

id - the source id

geoJson - raw Json body

options - options

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     java.net.URL url)

Create a GeoJsonSource from a remote geo json file

Parameters:

id - the source id

url - remote json file

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     java.net.URL url,
                     GeoJsonOptions options)

Create a GeoJsonSource from a remote geo json file and non-default GeoJsonOptions

Parameters:

id - the source id

url - remote json file

options - options

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     FeatureCollection features)

Create a GeoJsonSource from a FeatureCollection.

Parameters:

id - the source id

features - the features

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     FeatureCollection features,
                     GeoJsonOptions options)

Create a GeoJsonSource from a FeatureCollection and non-default GeoJsonOptions.

Parameters:

id - the source id

features - the features

options - options

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     Feature feature)

Create a GeoJsonSource from a Feature

Parameters:

id - the source id

feature - the feature

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     Feature feature,
                     GeoJsonOptions options)

Create a GeoJsonSource from a Feature and non-default GeoJsonOptions

Parameters:

id - the source id

feature - the feature

options - options

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     Geometry geometry)

Create a GeoJsonSource from a Geometry

Parameters:

id - the source id

geometry - the geometry

GeoJsonSource

public GeoJsonSource(java.lang.String id,
                     Geometry geometry,
                     GeoJsonOptions options)

Create a GeoJsonSource from a Geometry and non-default GeoJsonOptions

Parameters:

id - the source id

geometry - the geometry

options - options

Method Detail

setGeoJson

public void setGeoJson(Feature feature)

Updates the GeoJson with a single feature. The update is performed asynchronously, so the data won't be immediately visible or available to query when this method returns.

Parameters:

feature - the GeoJSON Feature to set

setGeoJson

public void setGeoJson(Geometry geometry)

Updates the GeoJson with a single geometry. The update is performed asynchronously, so the data won't be immediately visible or available to query when this method returns.

Parameters:

geometry - the GeoJSON Geometry to set

setGeoJson

public void setGeoJson(FeatureCollection features)

Updates the GeoJson. The update is performed asynchronously, so the data won't be immediately visible or available to query when this method returns.

Parameters:

features - the GeoJSON FeatureCollection

setUrl

public void setUrl(java.net.URL url)

Updates the url

Parameters:

url - the GeoJSON FeatureCollection url

setUrl

public void setUrl(java.lang.String url)

Updates the url

Parameters:

url - the GeoJSON FeatureCollection url

getUrl

public java.lang.String getUrl()

Returns:

The url or null

querySourceFeatures

public java.util.List<Feature> querySourceFeatures(Expression filter)

Queries the source for features.

Parameters:

filter - an optional filter expression to filter the returned Features

Returns:

the features

getClusterChildren

public FeatureCollection getClusterChildren(Feature cluster)

Returns the children of a cluster (on the next zoom level) given its id (cluster_id value from feature properties).

Requires configuring this source as a cluster by calling GeoJsonOptions.withCluster(boolean).

Parameters:

cluster - cluster from which to retrieve children from

Returns:

a list of features for the underlying children

getClusterLeaves

public FeatureCollection getClusterLeaves(Feature cluster,
                                          long limit,
                                          long offset)

Returns all the leaves of a cluster (given its cluster_id), with pagination support: limit is the number of leaves to return (set to Infinity for all points), and offset is the amount of points to skip (for pagination).

Requires configuring this source as a cluster by calling GeoJsonOptions.withCluster(boolean).

Parameters:

cluster - cluster from which to retrieve leaves from

limit - limit is the number of points to return

offset - offset is the amount of points to skip (for pagination)

Returns:

a list of features for the underlying leaves

getClusterExpansionZoom

public int getClusterExpansionZoom(Feature cluster)

Returns the zoom on which the cluster expands into several children (useful for "click to zoom" feature) given the cluster's cluster_id (cluster_id value from feature properties).

Requires configuring this source as a cluster by calling GeoJsonOptions.withCluster(boolean).

Parameters:

cluster - cluster from which to retrieve the expansion zoom from

Returns:

the zoom on which the cluster expands into several children

initialize

protected void initialize(java.lang.String layerId,
                          java.lang.Object options)

nativeSetUrl

protected void nativeSetUrl(java.lang.String url)

nativeGetUrl

protected java.lang.String nativeGetUrl()

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable