Determines the street segment length or the length of a diagonal.
Syntax
05 GDL-GET-STREET-LENGTH.
10 GDL-GSL-GEOSTAN PIC S9(09) BINARY.
10 GDL-GSL-POINT PIC S9(09) BINARY.
10 GDL-GSL-LENGTH PIC S9(09) BINARY.
*
CALL "GDLGSL"
USING GDL-GET-STREET-LENGTH, GDL-RETURN-CODE.Arguments
GDL-GSL-GEOSTAN
The gdlHandle initialized by GDLINIT (GDL-INIT- HANDLE). Input.
GDL-GSL-POINT
Pointer to a gdlShape that contains the geocode coordinates. Output.
GDL-GSL-LENGTH
The length of the street segment, or the length of the MBR diagonal. Output.
Return Values
| GDL-OK | Success |
| GDL-ERROR | An internal error occurred or GeoStan was not used to find an address prior to this call |
Prerequisites
GDLINIT and GSFIND (from GeoStan)
Alternates
None.
Notes
Given a GeoStan/zOS handle, we can determine the street segment length for address level geocodes. The street length values can be used to make a fast determination of complete polygon inclusion when used in conjunction with the GDLPIP and GDLND procedures.
A GeoStan/zOS handle remains valid after calling GDLGSL.
Following instances of point arguments of this procedure, you should call GDLSF with the output point when you are finished using the output point to release system resources.