public class MapboxMapOptions
extends java.lang.Object
implements android.os.Parcelable
Modifier and Type | Field and Description |
---|---|
static android.os.Parcelable.Creator<MapboxMapOptions> |
CREATOR |
Constructor and Description |
---|
MapboxMapOptions()
Deprecated.
Use
createFromAttributes(Context, AttributeSet) instead. |
Modifier and Type | Method and Description |
---|---|
MapboxMapOptions |
apiBaseUri(java.lang.String apiBaseUri)
Specifies the URI used for API endpoint.
|
MapboxMapOptions |
apiBaseUrl(java.lang.String apiBaseUrl)
Deprecated.
use
apiBaseUri instead |
MapboxMapOptions |
attributionEnabled(boolean enabled)
Specifies the visibility state of a attribution for a map view.
|
MapboxMapOptions |
attributionGravity(int gravity)
Specifies the gravity state of attribution for a map view.
|
MapboxMapOptions |
attributionMargins(int[] margins)
Specifies the margin state of attribution for a map view
|
MapboxMapOptions |
attributionTintColor(int color)
Specifies the tint color of the attribution for a map view
|
MapboxMapOptions |
camera(CameraPosition cameraPosition)
Specifies a the initial camera position for the map view.
|
MapboxMapOptions |
compassEnabled(boolean enabled)
Specifies the visibility state of a mapbox_compass_icon for a map view.
|
MapboxMapOptions |
compassFadesWhenFacingNorth(boolean compassFadeWhenFacingNorth)
Specifies if the mapbox_compass_icon fades to invisible when facing north.
|
MapboxMapOptions |
compassGravity(int gravity)
Specifies the gravity state of mapbox_compass_icon for a map view.
|
MapboxMapOptions |
compassImage(android.graphics.drawable.Drawable compass)
Deprecated.
use
compassImageResource instead |
MapboxMapOptions |
compassImageResource(int compassImageResource)
Specifies the image of the CompassView.
|
MapboxMapOptions |
compassMargins(int[] margins)
Specifies the margin state of mapbox_compass_icon for a map view
|
static MapboxMapOptions |
createFromAttributes(android.content.Context context)
Creates a default MapboxMapsOptions from a given context.
|
static MapboxMapOptions |
createFromAttributes(android.content.Context context,
android.util.AttributeSet attrs)
Creates a MapboxMapsOptions from the attribute set.
|
MapboxMapOptions |
crossSourceCollisions(boolean crossSourceCollisions)
Enable cross-source symbol collision detection, defaults to true.
|
MapboxMapOptions |
debugActive(boolean enabled)
Specifies the used debug type for a map view.
|
int |
describeContents() |
MapboxMapOptions |
doubleTapGesturesEnabled(boolean enabled)
Specifies if the double tap gesture is enabled for a map view.
|
boolean |
equals(java.lang.Object o) |
MapboxMapOptions |
foregroundLoadColor(int loadColor)
Set the MapView foreground color that is used when the map surface is being created.
|
java.lang.String |
getApiBaseUri()
Get the current configured API endpoint base URI.
|
java.lang.String |
getApiBaseUrl()
Deprecated.
use
getApiBaseUri() instead |
boolean |
getAttributionEnabled()
Get the current configured visibility state for attribution for a map view.
|
int |
getAttributionGravity()
Get the current configured gravity state for attribution for a map view.
|
int[] |
getAttributionMargins()
Get the current configured margins for attribution for a map view.
|
int |
getAttributionTintColor()
Get the current configured tint color for attribution for a map view.
|
CameraPosition |
getCamera()
Get the current configured initial camera position for a map view.
|
boolean |
getCompassEnabled()
Get the current configured visibility state for mapbox_compass_icon for a map view.
|
boolean |
getCompassFadeFacingNorth()
Get the current configured state for fading the mapbox_compass_icon when facing north.
|
int |
getCompassGravity()
Get the current configured gravity state for mapbox_compass_icon for a map view.
|
android.graphics.drawable.Drawable |
getCompassImage()
Deprecated.
|
int |
getCompassImageResource()
Get the current configured CompassView image resource id.
|
int[] |
getCompassMargins()
Get the current configured margins for mapbox_compass_icon for a map view.
|
boolean |
getCrossSourceCollisions()
Check whether cross-source symbol collision detection is enabled.
|
boolean |
getDebugActive()
Get the current configured debug state for a map view.
|
boolean |
getDoubleTapGesturesEnabled()
Get the current configured double tap gesture state for a map view.
|
int |
getForegroundLoadColor()
Returns the current configured foreground color that is used during map creation.
|
GlyphsRasterizationMode |
getGlyphsRasterizationMode()
Experimental.
|
boolean |
getHorizontalScrollGesturesEnabled()
Get the current configured horizontal scroll gesture state for a map view.
|
java.lang.String |
getLocalIdeographFontFamily()
Returns the font-family for locally overriding generation of glyphs in the
'CJK Unified Ideographs' and 'Hangul Syllables' ranges.
|
boolean |
getLogoEnabled()
Get the current configured visibility state for mapbox_compass_icon for a map view.
|
int |
getLogoGravity()
Get the current configured gravity state for logo for a map view.
|
int[] |
getLogoMargins()
Get the current configured margins for logo for a map view.
|
double |
getMaxPitchPreference()
Get the current configured maximum pitch for a map view.
|
double |
getMaxZoomPreference()
Get the current configured maximum zoom for a map view.
|
double |
getMinPitchPreference()
Get the current configured min pitch for a map view.
|
double |
getMinZoomPreference()
Get the current configured min zoom for a map view.
|
float |
getPixelRatio()
Return the custom configured pixel ratio, returns 0 if not configured.
|
boolean |
getPrefetchesTiles()
Deprecated.
Use
getPrefetchZoomDelta() instead. |
int |
getPrefetchZoomDelta()
Check current pre-fetching zoom delta.
|
boolean |
getQuickZoomGesturesEnabled()
Get whether the user may zoom the map by tapping twice, holding and moving the pointer up and down.
|
boolean |
getRenderSurfaceOnTop()
Get the flag to render the map surface on top of another surface.
|
boolean |
getRotateGesturesEnabled()
Get the current configured rotate gesture state for a map view.
|
boolean |
getScrollGesturesEnabled()
Get the current configured scroll gesture state for a map view.
|
boolean |
getTextureMode()
Returns true if TextureView is being used the render view.
|
boolean |
getTiltGesturesEnabled()
Get the current configured tilt gesture state for a map view.
|
boolean |
getTranslucentTextureSurface()
Returns true if TextureView supports a translucent surface
|
boolean |
getZoomGesturesEnabled()
Get the current configured zoom gesture state for a map view.
|
int |
hashCode() |
MapboxMapOptions |
horizontalScrollGesturesEnabled(boolean enabled)
Specifies if the horizontal scroll gesture is enabled for a map view.
|
boolean |
isLocalIdeographFontFamilyEnabled()
Returns true if local ideograph font family is enabled, defaults to true.
|
MapboxMapOptions |
localIdeographFontFamily(java.lang.String... fontFamilies)
Set a font family from range of font families for generating glyphs locally for ideographs in the
'CJK Unified Ideographs' and 'Hangul Syllables' ranges.
|
MapboxMapOptions |
localIdeographFontFamily(java.lang.String fontFamily)
Set the font family for generating glyphs locally for ideographs in the 'CJK Unified Ideographs'
and 'Hangul Syllables' ranges.
|
MapboxMapOptions |
localIdeographFontFamilyEnabled(boolean enabled)
Enable local ideograph font family, defaults to true.
|
MapboxMapOptions |
logoEnabled(boolean enabled)
Specifies the visibility state of a logo for a map view.
|
MapboxMapOptions |
logoGravity(int gravity)
Specifies the gravity state of logo for a map view.
|
MapboxMapOptions |
logoMargins(int[] margins)
Specifies the margin state of logo for a map view
|
MapboxMapOptions |
maxPitchPreference(double maxPitch)
Specifies the used maximum pitch for a map view.
|
MapboxMapOptions |
maxZoomPreference(double maxZoom)
Specifies the used maximum zoom level for a map view.
|
MapboxMapOptions |
minPitchPreference(double minPitch)
Specifies the used minimum pitch for a map view.
|
MapboxMapOptions |
minZoomPreference(double minZoom)
Specifies the used minimum zoom level for a map view.
|
MapboxMapOptions |
pixelRatio(float pixelRatio)
Set the custom pixel ratio configuration to override the default value from resources.
|
MapboxMapOptions |
quickZoomGesturesEnabled(boolean enabled)
Specifies whether the user may zoom the map by tapping twice, holding and moving the pointer up and down.
|
void |
renderSurfaceOnTop(boolean renderOnTop)
Set the flag to render the map surface on top of another surface.
|
MapboxMapOptions |
rotateGesturesEnabled(boolean enabled)
Specifies if the rotate gesture is enabled for a map view.
|
MapboxMapOptions |
scrollGesturesEnabled(boolean enabled)
Specifies if the scroll gesture is enabled for a map view.
|
MapboxMapOptions |
setPrefetchesTiles(boolean enable)
Deprecated.
Use
setPrefetchZoomDelta(int) instead. |
MapboxMapOptions |
setPrefetchZoomDelta(int delta)
Set the tile pre-fetching zoom delta.
|
void |
setRasterizationMode(GlyphsRasterizationMode glyphsRasterizationMode)
Experimental.
|
MapboxMapOptions |
textureMode(boolean textureMode)
Enable
TextureView as rendered surface. |
MapboxMapOptions |
tiltGesturesEnabled(boolean enabled)
Specifies if the tilt gesture is enabled for a map view.
|
MapboxMapOptions |
translucentTextureSurface(boolean translucentTextureSurface) |
void |
writeToParcel(android.os.Parcel dest,
int flags) |
MapboxMapOptions |
zoomGesturesEnabled(boolean enabled)
Specifies if the zoom gesture is enabled for a map view.
|
public static final android.os.Parcelable.Creator<MapboxMapOptions> CREATOR
@Deprecated public MapboxMapOptions()
createFromAttributes(Context, AttributeSet)
instead.@NonNull public static MapboxMapOptions createFromAttributes(@NonNull android.content.Context context)
context
- Context related to a map view.@NonNull public static MapboxMapOptions createFromAttributes(@NonNull android.content.Context context, @Nullable android.util.AttributeSet attrs)
context
- Context related to a map view.attrs
- Attributeset containing configurationpublic void setRasterizationMode(GlyphsRasterizationMode glyphsRasterizationMode)
glyphsRasterizationMode
- the glyphs rasterization mode will be used.public GlyphsRasterizationMode getGlyphsRasterizationMode()
@Deprecated @NonNull public MapboxMapOptions apiBaseUrl(java.lang.String apiBaseUrl)
apiBaseUri
insteadapiBaseUrl
- The base of our API endpoint@NonNull public MapboxMapOptions apiBaseUri(java.lang.String apiBaseUri)
apiBaseUri
- The base of our API endpoint@NonNull public MapboxMapOptions camera(CameraPosition cameraPosition)
cameraPosition
- Inital camera position@NonNull public MapboxMapOptions debugActive(boolean enabled)
enabled
- True is debug is enabled@NonNull public MapboxMapOptions minZoomPreference(double minZoom)
minZoom
- Zoom level to be used@NonNull public MapboxMapOptions maxZoomPreference(double maxZoom)
maxZoom
- Zoom level to be used@NonNull public MapboxMapOptions minPitchPreference(double minPitch)
minPitch
- Pitch to be used@NonNull public MapboxMapOptions maxPitchPreference(double maxPitch)
maxPitch
- Pitch to be used@NonNull public MapboxMapOptions compassEnabled(boolean enabled)
enabled
- True and mapbox_compass_icon is shown@NonNull public MapboxMapOptions compassGravity(int gravity)
gravity
- Android SDK Gravity.@NonNull public MapboxMapOptions compassMargins(int[] margins)
margins
- 4 long array for LTRB margins@NonNull public MapboxMapOptions compassFadesWhenFacingNorth(boolean compassFadeWhenFacingNorth)
By default this value is true.
compassFadeWhenFacingNorth
- true is mapbox_compass_icon fades to invisble@NonNull public MapboxMapOptions compassImage(android.graphics.drawable.Drawable compass)
compassImageResource
insteadBy default this value is R.drawable.mapbox_compass_icon.
compass
- the drawable to show as image compass@NonNull public MapboxMapOptions compassImageResource(@DrawableRes int compassImageResource)
By default this value is R.drawable.mapbox_compass_icon.
compassImageResource
- the drawable resource id to show as image compass@NonNull public MapboxMapOptions logoEnabled(boolean enabled)
enabled
- True and logo is shown@NonNull public MapboxMapOptions logoGravity(int gravity)
gravity
- Android SDK Gravity.@NonNull public MapboxMapOptions logoMargins(int[] margins)
margins
- 4 long array for LTRB margins@NonNull public MapboxMapOptions attributionEnabled(boolean enabled)
enabled
- True and attribution is shown@NonNull public MapboxMapOptions attributionGravity(int gravity)
gravity
- Android SDK Gravity.@NonNull public MapboxMapOptions attributionMargins(int[] margins)
margins
- 4 long array for LTRB margins@NonNull public MapboxMapOptions attributionTintColor(@ColorInt int color)
color
- integer resembling a color@NonNull public MapboxMapOptions rotateGesturesEnabled(boolean enabled)
enabled
- True and gesture will be enabled@NonNull public MapboxMapOptions scrollGesturesEnabled(boolean enabled)
enabled
- True and gesture will be enabled@NonNull public MapboxMapOptions horizontalScrollGesturesEnabled(boolean enabled)
enabled
- True and gesture will be enabled@NonNull public MapboxMapOptions tiltGesturesEnabled(boolean enabled)
enabled
- True and gesture will be enabled@NonNull public MapboxMapOptions zoomGesturesEnabled(boolean enabled)
enabled
- True and gesture will be enabled@NonNull public MapboxMapOptions doubleTapGesturesEnabled(boolean enabled)
enabled
- True and gesture will be enabled@NonNull public MapboxMapOptions quickZoomGesturesEnabled(boolean enabled)
enabled
- True and gesture will be enabled@NonNull public MapboxMapOptions textureMode(boolean textureMode)
TextureView
as rendered surface.
Since the 5.2.0 release we replaced our TextureView with an GLSurfaceView
implementation. Enabling this option will use the TextureView
instead.
TextureView
can be useful in situations where you need to animate, scale
or transform the view. This comes at a siginficant performance penalty and should not be considered
unless absolutely needed.
textureMode
- True to enable texture mode@NonNull public MapboxMapOptions translucentTextureSurface(boolean translucentTextureSurface)
@NonNull public MapboxMapOptions foregroundLoadColor(@ColorInt int loadColor)
loadColor
- the color to show during map creation@Deprecated @NonNull public MapboxMapOptions setPrefetchesTiles(boolean enable)
setPrefetchZoomDelta(int)
instead.enable
- true to enable@NonNull public MapboxMapOptions setPrefetchZoomDelta(@IntRange(from=0L) int delta)
delta
- zoom delta@NonNull public MapboxMapOptions crossSourceCollisions(boolean crossSourceCollisions)
If set to false, symbol layers will only run collision detection against other symbol layers that are part of the same source.
crossSourceCollisions
- true to enable, false to disable@NonNull public MapboxMapOptions localIdeographFontFamilyEnabled(boolean enabled)
enabled
- true to enable, false to disable@NonNull public MapboxMapOptions localIdeographFontFamily(java.lang.String fontFamily)
The font family argument is passed to Typeface.create(String, int)
.
Default system fonts are defined in '/system/etc/fonts.xml'
Default font for local ideograph font family is MapboxConstants.DEFAULT_FONT
.
fontFamily
- font family for local ideograph generation.@NonNull public MapboxMapOptions localIdeographFontFamily(java.lang.String... fontFamilies)
MapboxConstants.DEFAULT_FONT
.
The font families are checked against the default system fonts defined in
'/system/etc/fonts.xml' Default font for local ideograph font family is
MapboxConstants.DEFAULT_FONT
.
fontFamilies
- an array of font families for local ideograph generation.@NonNull public MapboxMapOptions pixelRatio(float pixelRatio)
pixelRatio
- the custom pixel ratio of the map under construction@Deprecated public boolean getPrefetchesTiles()
getPrefetchZoomDelta()
instead.@IntRange(from=0L) public int getPrefetchZoomDelta()
public boolean getCrossSourceCollisions()
public void renderSurfaceOnTop(boolean renderOnTop)
renderOnTop
- true if this map is shown on top of another one, false if bottom.public boolean getRenderSurfaceOnTop()
@Deprecated public java.lang.String getApiBaseUrl()
getApiBaseUri()
insteadpublic java.lang.String getApiBaseUri()
public CameraPosition getCamera()
public double getMinZoomPreference()
public double getMaxZoomPreference()
public double getMinPitchPreference()
public double getMaxPitchPreference()
public boolean getCompassEnabled()
public int getCompassGravity()
public int[] getCompassMargins()
public boolean getCompassFadeFacingNorth()
@Deprecated public android.graphics.drawable.Drawable getCompassImage()
@DrawableRes public int getCompassImageResource()
public boolean getLogoEnabled()
public int getLogoGravity()
public int[] getLogoMargins()
public boolean getRotateGesturesEnabled()
public boolean getScrollGesturesEnabled()
public boolean getHorizontalScrollGesturesEnabled()
public boolean getTiltGesturesEnabled()
public boolean getZoomGesturesEnabled()
public boolean getDoubleTapGesturesEnabled()
public boolean getQuickZoomGesturesEnabled()
public boolean getAttributionEnabled()
public int getAttributionGravity()
public int[] getAttributionMargins()
@ColorInt public int getAttributionTintColor()
public boolean getDebugActive()
public boolean getTextureMode()
public boolean getTranslucentTextureSurface()
@ColorInt public int getForegroundLoadColor()
@Nullable public java.lang.String getLocalIdeographFontFamily()
MapboxConstants.DEFAULT_FONT
.
Returns null if local ideograph font families are disabled.public boolean isLocalIdeographFontFamilyEnabled()
public float getPixelRatio()
public int describeContents()
describeContents
in interface android.os.Parcelable
public void writeToParcel(@NonNull android.os.Parcel dest, int flags)
writeToParcel
in interface android.os.Parcelable
public boolean equals(@Nullable java.lang.Object o)
equals
in class java.lang.Object
public int hashCode()
hashCode
in class java.lang.Object