Deprecated. Retrieves the coordinates for a street segment object found via GSFFSEG and GSFNRANG.
Syntax
01 GSID PIC S9(9) BINARY.
01 GSFUNSTAT PIC S9(9) BINARY.
01 SEGMENT-HANDLE PIC S9(9) BINARY.
01 MAXPOINTS PIC 9(4) BINARY.
01 COORDS OCCURS <nnn> TIMES.
05 COORD-X PIC S9(9) BINARY.
05 CORRD-Y PIC S9(9) BINARY.
*
CALL "GSHGCRD" USING GSID, SEGMENT-HANDLE, COORDS, MAXPOINTS, GSFUNSTAT.Arguments
GSID ID returned by GSINIT for the current instance of GeoStan. Input.
GSFUNSTAT return value for the procedure. Output.
SEGMENT-HANDLE Handle of the segment object for the returned coordinates. Input.
COORDS Array of coordinates, in x,y (longitude, latitude) order. Output.
MAXPOINTS Maximum number of points that GSGCRD returns; used to prevent writing past the end of COORDS buffer. Input.
Return Values
Number of points assigned to the buffer.
Prerequisites
GSFFSEG or GSFNRANGNotes
This procedure returns an array of coordinates for the segment identified in SEGMENT-HANDLE.