gdlFarDistance - 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 distance between the farthest point of the error surface and the nearest point of the feature (point or line).

Syntax

intl gdlFarDistance( gdlHandle hGdl, gdlShape shape1, gdlShape shape2, intl* distance );

Arguments

hGdl

The gdlHandle initialized by gdlInitialize. Input.

shape1

The gdlShape object representing the error surface. Input.

shape2

The gdlShape object representing the object found using gdlFindNearest (or gdlFindNext). Input.

distance

The distance in feet. Output.

Return values

GDL_NOT_LICENSED

GDL_ERROR

GDL_OK

Prerequisites

gdlFindNearest

gdlGenerateErrorSurface

Alternates

gdlNearDistance

Note: To return the distance from the farthest point of the error surface to the nearest point of the feature, the error surface must be passed in as shape1 and the feature as shape2.

Notes

The following diagram illustrates the distance between the farthest point of the error surface and the nearest point of a line: