Finds the first polygon that contains the input point.
Syntax
05 GDL-POINT-IN-POLYGON.
10 GDL-PIP-HANDLE PIC S9(09) BINARY.
10 GDL-PIP-POINT PIC S9(09) BINARY.
10 GDL-PIP-POLYGON PIC S9(09) BINARY.
*
CALL "GDLPIP"
USING GDL-POINT-IN-POLYGON, GDL-RETURN-CODE.Arguments
GDL-PIP-HANDLE
The gdlFileHandle returned by GDLOSF (GDL-OSF- SPATIAL-HANDLE). Input.
GDL-PIP-POINT
Pointer to a gdlShape that contains the geocode coordinates. Input.
GDL-PIP-POLYGON
A pointer to the first polygon. Output.
Return Values
| GDL-OK | Success |
| GDL-ERROR | An internal error occurred |
| GDL-NOT-FOUND | No enclosing regions were found |
| GDL-WRONG-TYPE | GDL-PIP-POINT is not a Point |
Prerequisites
GDLOSF
Alternates
None.
Notes
Call GDLSF on the output polygon.
The following diagram illustrates the first polygon that contains the input point:
