AGSPointBuilder Class Reference

Description

A builder to build point geometries.

Instances of this class represent a builder that can build point geometries. Point geometries are immutable, they cannot be modified after they are created. Use builders to create new geometries either from scratch, or by using an existing geometry as a starting off point. Modifications made through the builder affect only its own internal copy of the geometry. They do not affect the original geometry.

Since

100

See also

AGSSketchEditor to construct or modify geometries interactively by sketching on a map

Inheritance diagram for AGSPointBuilder:

Instance Methods
(instancetype)	- initWithPoint:
(instancetype)	- initWithSpatialReference:
(BOOL)	- isEmpty
(instancetype)	- offsetByX:y:
(instancetype)	- replaceGeometry:
(instancetype)	- replaceGeometry:
(instancetype)	- setX:y:
(AGSPoint *)	- toGeometry

Class Methods
(AGSGeometryBuilder *)	+ builderWithGeometry:
(AGSGeometryBuilder *)	+ builderWithGeometryType:spatialReference:
(instancetype)	+ pointBuilderWithPoint:
(instancetype)	+ pointBuilderWithSpatialReference:

Properties
AGSEnvelope *	extent
AGSGeometryType	geometryType
BOOL	hasM
BOOL	hasZ
double	m
AGSSpatialReference *	spatialReference
double	x
double	y
double	z

Method Documentation

builderWithGeometry:()

+ (AGSGeometryBuilder*) builderWithGeometry:

(nullable AGSGeometry *)

geometry

Factory method to create a geometry builder from a geometry.

Parameters

geometry

The geometry to be used as the starting point for further modifications

Since

100

builderWithGeometryType:spatialReference:()

+ (AGSGeometryBuilder*) builderWithGeometryType:		(AGSGeometryType)	geometryType
spatialReference:		(nullable AGSSpatialReference *)	sr

Factory method to create a geometry builder from a geometry type and spatial reference.

Parameters

geometryType	The type of geometry to be constructed
sr	The spatial reference for the geometry to be constructed

Since

100

initWithPoint:()

- (instancetype) initWithPoint:

(nullable AGSPoint *)

point

Initializes a point builder.

Parameters

point

The geometry to be used as the starting point for further modifications. Can be nil.

Since

100

initWithSpatialReference:()

- (instancetype) initWithSpatialReference:

(nullable AGSSpatialReference *)

sr

Initializes a builder.

Parameters

sr	The spatial reference for the geometry to be constructed

Since

100

isEmpty()

- (BOOL) isEmpty

Indicates whether the builder's geometry is empty.

Returns

YES if the geometry is empty

Since

100

See also

AGSGeometry::isEmpty

offsetByX:y:()

- (instancetype) offsetByX:		(double)	xOffset
y:		(double)	yOffset

Move the builder's point geometry.

Parameters

xOffset	offset along x-axis (negative value moves the point east)
yOffset	offset along y-axis (negative value moves the point south)

Returns

the builder so you can easily chain method calls

Since

100

pointBuilderWithPoint:()

+ (instancetype) pointBuilderWithPoint:

(nullable AGSPoint *)

point

Initializes a point builder.

Parameters

point

The geometry to be used as the starting point for further modifications. Can be nil.

Since

100

pointBuilderWithSpatialReference:()

+ (instancetype) pointBuilderWithSpatialReference:

(nullable AGSSpatialReference *)

sr

Initializes a builder.

Parameters

sr	The spatial reference for the geometry to be constructed

Since

100

replaceGeometry:() [1/2]

- (instancetype) replaceGeometry:

(nullable AGSGeometry *)

geometry

Replaces the builder's geometry with the provided one.

Parameters

geometry

to replace with

Returns

the builder so you can easily chain method calls

Since

100

replaceGeometry:() [2/2]

- (instancetype) replaceGeometry:

(nullable AGSPoint *)

geometry

Replaces the builder's geometry with the provided one.

Parameters

geometry

to replace with

Returns

the builder so you can easily chain method calls

Since

100

setX:y:()

- (instancetype) setX:		(double)	x
y:		(double)	y

Update the builder's point geometry.

Parameters

x	coordinate
y	coordinate

Returns

the builder so you can easily chain method calls

Since

100

toGeometry()

- (AGSPoint*) toGeometry

Returns the point geometry this builder is constructing or modifying.

Returns

geometry

Since

100

Implements AGSGeometryBuilder.

Property Documentation

extent

- (AGSEnvelope*) extent

readnonatomicstronginherited

Smallest, rectangular bounding-box that covers the builder's geometry.

Since

100

See also

AGSGeometry::extent

geometryType

- (AGSGeometryType) geometryType

readnonatomicassigninherited

The type of geometry the builder will construct or modify.

Since

100

hasM

- (BOOL) hasM

readnonatomicassigninherited

Indicates whether the builder's geometry contains m (measure) values.

Since

100

See also

AGSGeometry::hasM

hasZ

- (BOOL) hasZ

readnonatomicassigninherited

Indicates whether the builder's geometry contains z coordinate values.

Since

100

See also

AGSGeometry::hasZ

m

- (double) m

readwritenonatomicassign

The measure value of the builder's point geometry.

Since

100

spatialReference

- (AGSSpatialReference*) spatialReference

readnonatomicstronginherited

The spatial reference associated with the builder's gometry. It specifies the coordinate system for the geometry's x, y, and z coordinate values.

Since

100

Note

Geometries that represent geographic locations should always have a spatial reference. Otherwise the coordinates of the geometry are meaningless.

See also

AGSGeometry::spatialReference

x

- (double) x

readwritenonatomicassign

The position of the builder's point geometry along x-axis.

Since

100

y

- (double) y

readwritenonatomicassign

The position of the builder's point geometry along y-axis.

Since

100

z

- (double) z

readwritenonatomicassign

The position of the builder's point geometry along z-axis. Only applicable for 3D point geometries. The minimum z-value is -6,356,752 meters, which is the approximate radius of the earth (the WGS 84 datum semi-minor axis). The maximum z-value is 55,000,000 meters.

Since

100