Retrieves coordinates for the street segment found via GSSFIND.
Syntax
01 GSID PIC S9(9) BINARY.
01 GSFUNSTAT PIC 9(4) BINARY.
01 COORDS OCCURS 64 TIMES.
05 COORD-X PIC S9(9) BINARY.
05 COORD-Y PIC S9(9) BINARY.
01 MAXPOINTS PIC 9(4) BINARY.
*
CALL "GSGCRDX" USING GSID, COORDS, MAXPOINTS, GSFUNSTAT.Arguments
GSID ID returned by GSINIT for the current instance of GeoStan. Input.
GSFUNSTAT Return value for the procedure. Output.
COORDS Array of coordinates, in x,y (longitude, latitude) order. Output.
MAXPOINTS Maximum number of points that GSGCRDX should return; used to prevent writing past the end of COORDS buffer. Input.
Return Values
Number of points assigned to buffer.
Prerequisites
GSSFIND
Notes
This procedure returns an array of coordinates for the current feature found via GSSFIND. 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. Thus, 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 procedure before using them as input to other software libraries or applications.