gdlDistance - 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 straight line distance between two points.

Syntax

intl gdlDistance( gdlHandle hGdl, gdlShape point1, gdlShape point2, intl* distance );

Arguments

hGdl

The gdlHandle initialized by gdlInitialize. Input.

point1

Pointer to a gdlShape that contains the geocode coordinates representing the first point. Input.

point2

Pointer to a gdlShape that contains the geocode coordinates representing the second point. Input.

distance

The distance in feet. Output.

Return values

GDL_NOT_LICENSED

GDL_ERROR

GDL_WRONG_TYPE

GDL_OK

Prerequisites

gdlInitialize

gdlShapeCreate or gdlGenerateErrorSurface

Alternates

gdlManhattanDistance

Notes

The following diagram illustrates a straight line distance between two points: