Skip to main content

PointAnnotation

import { PointAnnotation } from '@rnmapbox/maps';

PointAnnotation

PointAnnotation represents a one-dimensional shape located at a single geographical coordinate.

Consider using ShapeSource and SymbolLayer instead, if you have many points and static images, they'll offer much better performance.

If you need interactive views please use MarkerView because PointAnnotation will render children onto a bitmap. Also disable any kind of animations like fadeDuration of Image. Otherwise, the bitmap might be rendered at an unknown state of the animation.

props​

id​

string

required A string that uniquely identifies the annotation

title​

string

The string containing the annotation’s title. Note this is required to be set if you want to see a callout appear on iOS.

snippet​

string

The string containing the annotation’s snippet(subtitle). Not displayed in the default callout.

selected​

boolean

Manually selects/deselects annotation

draggable​

boolean

Enable or disable dragging. Defaults to false.

defaults to: false

coordinate​

Position

required The center point (specified as a map coordinate) of the annotation.

anchor​

type Anchor = {
x: number; /* See anchor */
y: number; /* See anchor */
}

Specifies the anchor being set on a particular point of the annotation. The anchor point is specified in the continuous space [0.0, 1.0] x [0.0, 1.0], where (0, 0) is the top-left corner of the image, and (1, 1) is the bottom-right corner. Note this is only for custom annotations not the default pin view. Defaults to the center of the view.

defaults to: { x: 0.5, y: 0.5 }

onSelected​

func

This callback is fired once this annotation is selected. Returns a Feature as the first param. signature:(payload:Feature) => void

onDeselected​

func

This callback is fired once this annotation is deselected. signature:(payload:Feature) => void

onDragStart​

func

This callback is fired once this annotation has started being dragged. signature:(payload:Feature) => void

onDragEnd​

func

This callback is fired once this annotation has stopped being dragged. signature:(payload:Feature) => void

onDrag​

func

This callback is fired while this annotation is being dragged. signature:(payload:Feature) => void

children​

React.ReactElement | [React.ReactElement, React.ReactElement]

required Expects one child, and an optional callout can be added as well

style​

ViewProps['style']

FIX ME NO DESCRIPTION

methods​

refresh()​

On v10 and pre v10 android point annotation is rendered offscreen with a canvas into an image.
To rerender the image from the current state of the view call refresh.
Call this for example from Image#onLoad.

arguments​

NameTypeRequiredDescription

Show Point Annotations