GDLGSL - geographicdeterminationlibrary - 2024.00

Geographic Determination Library Reference for Windows and z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > Geographic Determination Library
Version
2024.00
Language
English
Product name
GeoStan Geocoding Suite
Title
Geographic Determination Library Reference for Windows and z/OS
Topic type
Reference
Copyright
2024
First publish date
1994
ft:lastEdition
2024-05-09
ft:lastPublication
2024-05-09T00:55:21.277227

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.