You are here: Using SOAP > v2006 services > Utility > Utility v2006 methods

Utility Web Service v2006 methods

To see Utility Web Service in action, interact with a live sample of a Utility client.

convertCircleToGeometry(circle:Circle, numPoints:integer, token:string):Geometry

convertCircularArcToGeometry(arc:CircularArc, numPoints:integer, token:string):Geometry

convertEllipseToGeometry(ellipse:Ellipse, numPoints:integer, token:string):Geometry

getBestProjection(extent:Envelope, token:string):Envelope

getDataCollectionDate(dataSource:string, extent:Envelope, mapSize:MapImageSize, token:string):string

getDistance(location1:Point, location2:Point, units:string, numPoints:integer, returnGeometry:boolean, token:string):DistanceInfo

getDriveTime(dataSource:string, point:Point, interval:integer, units:string, token:string):Geometry

getSupportedProjections(type:string, token:string):KeyValue[]

getVersion:string

projectExtent(extent:Envelope, projectTo:CoordSys, token:string):Envelope

projectGeometry(geometry:Geometry, projectTo:CoordSys, token:string):Geometry

projectPoint(point:Point, projectTo:CoordSys, token:string):Point

convertCircleToGeometry

Converts a circle to a polygon geometry. Use the input numPoints to set the shape of the polygon, for example, a value of "3" converts a circle to a triangle.

Endpoint URL

http://www.arcwebservices.com/services/v2006/Utility

Input

Name	Type	Valid values
circle	Circle	Circle parameters
numPoints	integer	The number of points in the polygon. A value of "0" returns 360 points. The maximum number of points is 10,000.
token	string	Authentication token

Output

Code examples

convertCircularArcToGeometry

Converts a circular arc to a line geometry.

Endpoint URL

http://www.arcwebservices.com/services/v2006/Utility

Input

Name	Type	Valid values
arc	CircularArc	CircularArc parameters
numPoints	integer	The number of points in the line. A value of "0" returns 360 points. The maximum number of points is 10,000.
token	string	Authentication token

Output

Code examples

convertEllipseToGeometry

Converts an ellipse to a polygon geometry. Use the input numPoints to set the shape of the polygon, for example, a value of "3" converts a circle to a triangle.

Endpoint URL

http://www.arcwebservices.com/services/v2006/Utility

Input

Name	Type	Valid values
ellipse	Ellipse	Ellipse parameters
numPoints	integer	The number of points in the polygon. A value of "0" returns 360 points. The maximum number of points is 10,000.
token	string	Authentication token

Output

Code examples

getBestProjection

Returns an optimal projection for the given extent.

Endpoint URL

http://www.arcwebservices.com/services/v2006/Utility

Input

Name	Type	Valid values
extent	Envelope	Envelope parameters
token	string	Authentication token

Output

Code examples

getDataCollectionDate

Returns the latest collection or processing date for data within a specified extent.

Endpoint URL

http://www.arcwebservices.com/services/v2006/Utility

Input

Name	Type	Valid values
dataSource	string	"ArcWeb:GlobeXplorer.DOQQ.US" "ArcWeb:GlobeXplorer.EarthSatNaturalVue.World" "ArcWeb:GlobeXplorer.Premium.World" "ArcWeb:GlobeXplorer.Standard.World"
extent	Envelope	Envelope parameters
mapSize	MapImageSize	MapImageSize parameters
token	string	Authentication token

Output

string

Code examples

getDistance

Returns the distance between two points. Assumes the shortest distance between the points lies on a great circle. A great circle is any circle or near circle produced by the intersection of a sphere and a flat plane that passes through the center of the sphere. The equator and all lines of longitude are great circles.

Endpoint URL

http://www.arcwebservices.com/services/v2006/Utility

Input

Name	Type	Valid values
location1	Point	Point parameters
location2	Point	Point parameters
numPoints	integer	The number of points in the output Geometry. Only used if returnGeometry is "true". A value of "0" returns 2 points. The maximum number of points is 10,000.
returnGeometry	boolean	"true" or "false" for whether the geometry in addition to the distance is returned
token		Authentication token
units	string	"km" (kilometers) or "miles" for the length of distance. Default value is "miles"

Output

Code examples

getDriveTime

Returns a polygon of the distance a vehicle can travel in X minutes or miles from a given starting point.

Endpoint URL

http://www.arcwebservices.com/services/v2006/Utility

Input

Name	Type	Valid values
dataSource	string	ArcWeb:TA.Streets.NA
point	Point	Point parameters for the starting coordinate of the drive time calculation.
interval	integer	Interval of distance or time. Be sure to set the appropriate units (km, miles, or minutes) for your interval. Default value is "minutes". Maximum values are "80" km, "50" miles, or "60" minutes.
units	string	"km" (kilometers), "miles", or "minutes" for the length of drive time.
token	string	Authentication token

Output

Code examples

getSupportedProjections

Returns a set of supported projections. Use with object CoordinateSys.

Endpoint URL

http://www.arcwebservices.com/services/v2006/Utility

Input

Name	Type	Valid values
type	string	A projection category. Valid values are "all", "geogcs" (geographic coordinate systems), "geogtran" (datum transformations), or "projcs" (projected coordinate system). Default value is "all".
token	string	Authentication token