GDLPIP - 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

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: