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

intl gdlPointInPolygon( gdlFileHandle hFile, gdlShape point, gdlShape* polygon );

Arguments

hFile

The gdlFileHandle returned by gdlOpenSpatialFile. Input.

point

Pointer to a gdlShape that contains the geocode coordinates. Input.

polygon

A pointer to the first polygon found to contain the input point. Output.

Return values

GDL_WRONG_TYPE

GDL_NOT_FOUND

GDL_ERROR

GDL_OK

Prerequisites

gdlOpenSpatialFile

gdlShapeCreate or gldGenerateErrorSurface

Alternates

None.

Notes

Call gdlShapeFree on the output polygon.

The following diagram illustrates the first polygon that contains the input point: