GsSetStreetCentroid - geostan_1 - 2024.01

GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > GeoStan
Version
2024.01
Language
English
Product name
GeoStan
Title
GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS
Copyright
2024
First publish date
1994
Last updated
2024-07-29
Published on
2024-07-29T23:01:18.924000

Deprecated. Used to enable street locator geocoding as an automatic geocoding fallback.

Syntax

qbool GsSetStreetCentroid( GsId gs, qbool GsStrCen );

Arguments

gs   ID returned by GsInit_r for the current instance of GeoStan. Input.

GsStrCen   Specifies whether or not to return a street segment geocode as an automatic geocoding fallback. Input.

n 0 = (default) Street locator disabled

n 1 = Return street segment geocode

Return Values

Current setting for this option (the setting before the change).

Prerequisites

GsInit_r

Notes

When this feature is enabled, if a street name is encountered while geocoding, and there is no matching address range, GeoStan will attempt to locate the street within the input ZIP Code or city if there is no input ZIP Code. If GeoStan is able to locate the street, it will return a geocode along the matched street segment rather than the geocode for the entered ZIP Code or ZIP + 4.

If a street number is entered, GeoStan will return the coordinates of the end point of the closest numeric street segment within the input ZIP Code. When there is no input ZIP Code, the closest numeric street segment of all the ZIP Codes within the input city will be returned.

If no street number is entered, the centroid of a matching street segment within the input ZIP Code will be returned. The centroid of a street segment for all the ZIP Codes within the input city will be returned when there is no input ZIP Code.

Match candidates may be returned. More information about the returned segment(s) can be obtained for either a single or a match candidate by calling GsMultipleGet().

Note: This option is not available in CASS mode.