Deprecated. Use GsGetCoordsEx for greater precision.
Syntax
ints GsGetCoords( GsId gs, pintl pCoords, intsu maxPoints
);
Arguments
gs ID returned by GsInit_r for the current instance of GeoStan. Input.
pCoords Array of coordinates, in x,y (longitude, latitude) order. Output.
maxPoints Maximum number of points to return; used to prevent writing past the end of the pCoords buffer. Input.
Return Values
Number of points assigned to buffer.
Prerequisites
GsFind
Notes
This function returns an array of coordinates for the current feature found via GsFind. The maximum number that GeoStan can return is 64 coordinate pairs, each pair consisting of two long integers.
GeoStan scales coordinate pairs to integers with four decimal digits of precision. For example, GeoStan returns a point at (-98.3, 29.7) as (983000, 297000). This is a different scale from that expected by Spatial+ and similar GIS applications, which typically express coordinates in millionths of degrees. You may need to scale coordinates obtained with this function before using them as input to other software libraries or applications.