Using building name, firm, and Point of Interest matching - 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

GeoStan can enhance standard address matching by matching to building and business names. Two optional POI files are available, Premium POI and POI.

By default, GeoStan is able to match building names with unit numbers in the address line, the Decatur Airport as an example:

Firm:
Address: 1 DECATUR AIRPORT
Last Line: DECATUR IL 62521

The returned information is the address of the Chrysler building. GeoStan returns a standardized address in place of the building name:

Firm:
Address: 910 S AIRPORT RD STE 1
Last Line: DECATUR IL 62521-4288

Entering Radio City Music Hall, as an example, into the address line, the address for Radio City Music Hall returns in the address field:

Firm:
Address: RADIO CITY MUSIC HALL
Last Line: NEW YORK, NY 10020

GeoStan returns the following address:

Firm:
Address: 1260 AVENUE OF THE AMERICAS
Last Line: NEW YORK, NY 10020-1701

The ability to search by building name entered in the address line is controlled by setting the find property, GS_FIND_BUILDING_SEARCH, to True.

Entering a firm name in the Firm name field returns the address for the input firm in the address field:

Firm: RADIO CITY MUSIC HALL
Address:
Last Line: NEW YORK, NY 10020

GeoStan returns the following address:

Firm: RADIO CITY MUSIC HALL
Address: 1260 AVENUE OF THE AMERICAS
Last Line: NEW YORK, NY 10020-1797
Note: GS_FIND_BUILDING_SEARCH is not available in CASS mode.

By modifying GS_FIND_ALTERNATE_LOOKUP, you can specify whether GeoStan searches for the following:

  • GS_STREET_LOOKUP_ONLY (default) - Matches to the address line.

  • GS_PREFER_STREET_LOOKUP  - Matches to the address line, if a match is not made, then GeoStan matches to the Firm name line.

  • GS_PREFER_FIRM_LOOKUP - Matches to the Firm name line, if a match is not made, then GeoStan matches to address line.

Note: Neither building nor firm name searches are available when processing in CASS mode.
Two optional index files are available which are POI (poi.gsi) and Premium POI (ppoi1.gsi, ppoi2.gsi, ppoi3.gsi).
Note: If a match occurs across multiple datasets, the match order will first be a Premium POI record, then POI, and finally USPS records.

Using the optional POI Index file

The optional Point Of Interest (POI) Index file (poi.gsi) included with the Master Location Data and HERE Point Addresses data sets provides expanded support in alias name matching.

To use the optional POI Index file:

  1. Set up your data.

    • On Windows/UNIX/Linux:

      • Install the MLD and/or HERE points, and streets data sets and their associated license files. Note down the paths to these folders.

      • Define the data paths to the geocoding data sets you have installed for your application. Define the paths to the associated license files and passwords.

    • On z/OS:

      • Upload the MLD and/or HERE points, and streets data sets.

      • There are three poi.gsi files. There needs to be a separate DD statement in your JCL for each file using the GSIFILxx DD name, for example:

    //GSDFILE  DD DSN=&GEOSPFX..US.GSD,DISP=SHR
//GSDFIL01 DD DSN=&GEOSPFX..MPOINTS1.GSD,DISP=SHR <=== MLD file
//GSIFILE  DD DSN=&GEOSPFX..MPOINTS1.GSI,DISP=SHR <=== MLD alias file
//GSDFIL02 DD DSN=&GEOSPFX..MPOINTS2.GSD,DISP=SHR <=== MLD file
//GSIFIL01 DD DSN=&GEOSPFX..MPOINTS2.GSI,DISP=SHR <=== MLD alias file
//GSDFIL03 DD DSN=&GEOSPFX..MPOINTS3.GSD,DISP=SHR <=== MLD file
//GSIFIL02 DD DSN=&GEOSPFX..MPOINTS3.GSI,DISP=SHR <=== MLD alias file
//GSIFIL03 DD DSN=&GEOSPFX..MLDPOI1.GSI,DISP=SHR <===MLD POI file
//GSIFIL04 DD DSN=&GEOSPFX..MLDPOI2.GSI,DISP=SHR <===MLD POI file
//GSIFIL05 DD DSN=&GEOSPFX..MLDPOI3.GSI,DISP=SHR <===MLD POI file
    Note: It does not matter what you name the files on the mainframe as long as the DD statements point to it.

  2. To confirm the poi.gsi loaded successfully, query the Status File POI Index status output property. Boolean. True = file loaded successfully. Default = False.

    C

    GS_STATUS_FILE_POI_IDX

    COBOL

    GS-STATUS-FILE-POI-IDX

    JAVA

    STATUS_FILE_POI_IDX

    .NET

    GS_STATUS_FILE_POI_IDX

  3. Set the GS_FIND_BUILDING_SEARCH find property to true. The POI Index file will automatically be searched when the GS_FIND_BUILDING_SEARCH find option is enabled and a firm, building or POI name is specified in the address line.

  4. Process the match by calling the Find Properties function.

If an alias match is made to the POI Index file, the return value is as follows:

C

GS_IS_ALIAS returns "A11".

COBOL

GS-IS-ALIAS returns "A11".

JAVA

IS_ALIAS returns "A11".

.NET

GS_IS_ALIAS returns "A11".

Using the optional Premium POI Index file

The optional Premium Point Of Interest (PPOI) Index file (ppoi1.gsi, ppoi2.gsi, ppoi3.gsi) included with the Master Location Data and HERE Point Addresses data sets provides expanded support in alias name matching.

To use the optional Premium POI Index file:

  1. Set up your data.

    • On Windows/UNIX/Linux:

      • Install the MLD and/or HERE points, and streets data sets and their associated license files. Note the paths to these folders.

      • Define the data paths to the geocoding data sets you have installed for your application. Define the paths to the associated license files and passwords.

    • On z/OS:

      • Upload the MLD and/or HERE points, and streets data sets.

      • There are three poi.gsi files. There needs to be a separate DD statement in your JCL for each file using the GSIFILxx DD name, for example:

    //GSDFILE  DD DSN=&GEOSPFX..US.GSD,DISP=SHR
//GSDFIL01 DD DSN=&GEOSPFX..MPOINTS1.GSD,DISP=SHR <=== MLD file
//GSIFILE  DD DSN=&GEOSPFX..MPOINTS1.GSI,DISP=SHR <=== MLD alias file
//GSDFIL02 DD DSN=&GEOSPFX..MPOINTS2.GSD,DISP=SHR <=== MLD file
//GSIFIL01 DD DSN=&GEOSPFX..MPOINTS2.GSI,DISP=SHR <=== MLD alias file
//GSDFIL03 DD DSN=&GEOSPFX..MPOINTS3.GSD,DISP=SHR <=== MLD file
//GSIFIL02 DD DSN=&GEOSPFX..MPOINTS3.GSI,DISP=SHR <=== MLD alias file
//GSIFIL03 DD DSN=&GEOSPFX..MLDPOI1.GSI,DISP=SHR <===MLD POI file
//GSIFIL04 DD DSN=&GEOSPFX..MLDPOI2.GSI,DISP=SHR <===MLD POI file
//GSIFIL05 DD DSN=&GEOSPFX..MLDPOI3.GSI,DISP=SHR <===MLD POI file
    Note: It does not matter what you name the files on the mainframe as long as the DD statements point to it.

  2. To confirm the ppoi1.gsi, ppoi2.gsi, and ppoi3.gsi loaded successfully, query the Status File POI Index status output property. Boolean. True = file loaded successfully. Default = False.

    C

    GS_STATUS_FILE_PREMIUM_POI_IDX

    COBOL

    GS-STATUS-FILE-PREMIUM_POI-IDX

    JAVA

    STATUS_FILE_PREMIUM_POI_IDX

    .NET

    GS_STATUS_FILE_PREMIUM_POI_IDX

  3. Set the GS_FIND_BUILDING_SEARCH find property to true. The Premium POI Index file will automatically be searched when the GS_FIND_BUILDING_SEARCH find option is enabled and a firm, building or POI name is specified in the address line.

  4. Process the match by calling the Find Properties function.

If an alias match is made to the Premium POI Index file, the return value is as follows:

C

GS_IS_ALIAS returns "A15".

COBOL

GS-IS-ALIAS returns "A15".

JAVA

IS_ALIAS returns "A15".

.NET

GS_IS_ALIAS returns "A15".