Your message is sent. We will get back to you as soon as possible. Thanks!

GOAT User Guide

Welcome to the Geographic Online Address Translator (GOAT)! GOAT allows you to enter a New York City geographic location, such as an address or street intersection, and returns back related geographic information, such as cross streets, side of street, tax block and lot (AKA Parcel –ID), five-digit ZIP code, census tract and block, police precinct, community district and City Council district.


General Information

GOAT is organized into individual functions; each identified by the type of input required along with a one- or two-character function code. Each function requires a separate set of input data, such as an address or place name, a street intersection or a tax lot, and returns a set of related geographic data.

To change to a different function at any time, select the appropriate tab at the top of the page, and GOAT will present an input page formatted for that function. Provide the appropriate input data (by filling in data boxes and making selections from pull-down menus, check boxes and radio buttons as required), then press the Submit button. If GOAT accepts the input data as valid, it returns output data. Otherwise, GOAT displays an error message indicating why the input data were not accepted. Sometimes GOAT will provide additional information with the output data as a warning message. A complete list of Geosupport (the software behind GOAT) Return Codes (GRCs) and Reason Codes can be found here.

If an inquiry is rejected and you wish to modify your input data and re-submit the inquiry, or if you wish to submit another inquiry using the same function, simply type over your previous data entries as needed and then press the Submit button. Remember to change the borough if necessary

If an inquiry is rejected and you believe the input to be valid, you may send feedback by clicking on the “Send Feedback” link. Please note that you may also send feedback when your inquiry is not rejected.

The glossary may be accessed by clicking on any of the label names in the output or by clicking here. When you ‘mouse over’ a label name, the color will change from black to a dark red. A single ‘click’ on the label name will bring you to the appropriate glossary entry.

Tips for Efficient Data Entry of Street Names

To minimize typing when entering street names, take advantage of the following features available with all GOAT functions:

Street directional and street type words may be entered in abbreviated form, such as ST for STREET, AV or AVE for AVENUE, E for EAST, BL or BLVD for BOULEVARD. For example, READE STREET may be entered as READE ST. In general, abbreviations that would be recognizable to a person are also recognizable to GOAT.

If the street name being entered has a word containing numeric digits, you need not enter the ordinal suffix (the characters 'st', 'nd', 'rd' or 'th' that can follow a numeric value). For example, WEST 23RD STREET may be entered as W 23 ST.

You may enter partial street names when they are unambiguous in a borough. For example, in the borough of Queens, GOAT recognizes MADISON as a partial name for MADISON STREET, since this is the only valid full name that begins with MADISON. However, in Manhattan, MADISON is ambiguous and is not accepted as an input street name, since both MADISON AVENUE and MADISON STREET are valid full names.

GOAT has three features to assist you with spelling street names and place names:

As you start to type, GOAT will pre-populate a dropdown list based on your entry. For example, if you start to type “Broadway”, 10 names beginning with “B” will appear. As you enter “BR”, the 10 names change to entries beginning with “BR”. And as you type “BRO”, another 10 names will appear. At this point, “BROADWAY” will appear in the list and you may select the name from the dropdown list or continue typing it in as you choose.

If you are not sure how to spell a name, you can also use the STREET (Name / Code) function and select an option to ‘Browse Street Name Dictionary’ to search through an alphabetical list of all the names that GOAT recognizes as valid.

Finally, if GOAT rejects a name that you have entered, the message will sometimes list one or more valid names that GOAT considers to be similar to the rejected input name. These are suggestions only; your intended name may not be any of these names. If you do recognize a similar name as your intended name, you may correct your input name by clicking on the appropriate ‘Copy to” (input field) and re-submitting your inquiry.

GOAT accepts the pseudo-street names BEND, DEAD END and CITY LIMIT as input street names under certain circumstances. They may not serve as input names for ADDRESS (Function 1B), but may serve as input names to INTERSECTION (Function 2). For STREET SEGMENT (Functions 3) and STREET STRETCH (Function 3S), they may serve as input cross street names only, not as the input 'on' street name.

Deep Linking

GOAT supports "Deep Linking" allowing users to pass in function parameters throught the URL and call functions automatically.

In order to call the functions, insert '?' after the function and seperate the parameters with '&'Boroughs must be 1,2,3,4 or 5.

Spaces in street name must with inserted with '%20'.

Everything is case sensitive. Compass inputs must be capital.

Compass parameter is optional and not required to get a hit.


Address Functions Parameters:

  • street

  • address

  • borough

  • unit (optional)

Example - /Function1E?borough=1&address=120&street=bwy


Function 2:

  • borough1

  • borough2

  • street1

  • street2

  • compass

Example - /Function2?borough1=1&borough2=1&street1=bwy&street2=cedar&compass=N


Function 3:

  • borough1

  • borough2

  • borough3

  • street1

  • street2

  • street3

  • compass

Example - /Function3?borough1=1&borough2=1&borough3=1&street1=bwy&street2=cedar&street3=thames&compass=N


Function 3S:

  • borough

  • street1

  • street2

  • street3

  • compass1

  • compass2

Example - /Function3S?borough=1&street1=bwy&street2=cedar&street3=thames&compass1=N&compass2=S


Function BL:

  • borough

  • block

  • lot

Example - /FunctionBL?borough=1&block=74&lot=7501


Function BN:

  • BIN

Example - /FunctionBN?bin=1001026


Function 1N:

  • street

Example - /Function1N?street=bwy


Function D:

  • B10SC

  • B10SC2

  • B10SC3

Example - /FunctionD?B10SC=11361001010&B10SC2=12887001&B10SC3=13239001


Function BF:

  • street

Example - /FunctionBF?street=bwy


Function N:

  • street

Example - /FunctionBF?street=bwy


Function 1L:

  • address

Example - /FunctionBF?address=120



ADDRESS Help

This screen allows for two options. A user can choose to “Display Street and Property Information” or “Display Address Point Information.

1. Display Street and Property Information (Function 1B)

The input data for Function 1B is an address or a place name. Two sets of geographic information are returned; political geography associated with the entire block face containing the input location, followed by property level and building specific output.

The acceptance of an address by Function 1B does not necessarily signify that an actual building exists having that address. You must check both sets of output. The geographic and political information returned in the upper portions of the output screen are related to an address range along a street block face. The information toward the bottom of the screen is property-level specific. An address range along a street block typically encompasses all possible addresses that could be assigned, such as 2 – 98 (on the even side of the street). However, in reality, there may only be buildings with the addresses 10, 34 and 76. Thus if another address within that range is entered, it will get a ‘hit’ on the street level information, but not on the property level information.

If property level information is returned, it generally signifies that an actual building exists having that address. However, the user should pay particular attention to the ‘Type’ column included in the Address Range List at the bottom of the screen to see if an address is listed as a ‘Pseudo Address'. ‘Pseudo Addresses' are addresses assigned by the Department of City Planning to some vacant street frontages to enable a property to be accessed. These addresses have no ‘official' status and should never be used outside of this system.

In addition to the ‘fixed' data returned, you have a choice of receiving a list of addresses which applies to the property and/or a list of BINs (Building Identification Numbers) that reside on the property identified by the input address. You may also elect to receive BIN information related to the Transitional PAD file (TPAD), and Roadbed Specific Information pertaining to the street level data. The input street name may also be normalized in a variety of ways (see Street (Name / Code) Help for more information.

Instructions for Entering Function 1B Input Data:

As input data to Function 1B, you may enter an address, consisting of an address number and a street name or an address number and a place name; or you may enter a place name alone without an address number.

Some place names serve as street names in that they combine with address numbers to form addresses. Some examples recognized by GOAT are: in Manhattan, CONFUCIUS PLAZA, PENN PLAZA and WASHINGTON SQUARE VILLAGE; in the Bronx, BRONX TERMINAL MARKET and FORDHAM PLAZA; in Brooklyn, METROTECH and FORT HAMILTON MANOR; and in Queens, ASTORIA SQUARE. To make a Function 1B inquiry for 2 Penn Plaza, for example, select Manhattan as the borough, enter 2 in the Address Number box, enter PENN PLAZA in the Street or Place Name box and press the Submit button.

Most place names do not combine with address numbers to form addresses, but rather, identify specific places by themselves. Some typical examples recognized by GOAT are EMPIRE STATE BUILDING, CARNEGIE HALL, CITI FIELD, LA GUARDIA AIRPORT. To make a Function 1B inquiry for a place name without an address number, first select the borough, make sure the Address Number box is blank, and then enter the place name in the Street or Place Name box. For example, to process EMPIRE STATE BUILDING, select Manhattan as the borough, make sure that the Address Number box is empty, and enter EMPIRE STATE BUILDING in the Street or Place Name box, and press the Submit button.

When entering an address number that normally contains a hyphen, such as most address numbers in Queens and a few address numbers in other boroughs, it is advisable to include the hyphen.

When entering an address number for the Edgewater Park neighborhood of the Bronx, make sure to include the proper section letter 'suffix' after the numeric address number (for example, 7A Edgewater Park). Valid suffixes for Edgewater Park are A, B, C, D and E.

If you select ‘Complete BIN List', you will receive a list of BINs as part of your output. If you do not select ‘BIN List', you will receive a list of up to twenty one addresses which apply to the property. For some properties, there are more than twenty one addresses. In these situations, in addition to the twenty one addresses starting with your input address, you will receive a warning message indicating that the lot has more addresses than are displayed.

The TPAD (Transitional Property Address Directory) option allows you to get up-to-date property related information. The TPAD file is updated daily with new information received from the Department of Buildings regarding job filings for new buildings and demolition jobs. Information regarding activity and status is returned.

The Roadbed Specific Information option will return roadbed-specific geocodes, assuming that the input street has multiple roadbeds. Examples of geocodes that would be different include Segment ID, Physical ID, Segment Type, and X,Y coordinates. Some City Service Information may vary as well.

2. Display Property Information (Function 1A)

Function 1A processes an input address or input NAP. When successfully called using two work areas, it returns information in Wa2 about the tax lot and the building (if any) identified by the input address or NAP.

3. Display Street Information (Function 1E)

Function 1E processes an input address or input NAP. When successfully called it returns a set of political districts, including Election, State Assembly, and Senate, City Council and Congressional Districs.

4. Display Address Point Information (Function AP)

Function AP returns Address Point information and some property level information of a given input address (house number and street name – there are no NAPs). Returned items are the Address Point ID and X, Y coordinates of the Address Point. Property level information such as the Borough-Block-Lot (BBL) of the input address are also returned.

Instruction for Entering Function AP Input Data:

As input data to Function AP, you may enter an address, consisting of an address number and a street name. Non-Addressable-Placenames (NAPs) are not allowed.


INTERSECTION (Function 2) Help

The input data to INTERSECTION (Function 2) is a street intersection. Function 2 returns geographic information related to the intersection, including the names of any additional streets that are at the intersection, and the administrative and political district identifiers within which the intersection is located. If an intersection lies on a boundary of two or more districts of a particular type, only one of those districts is listed.

Instructions for Entering Function 2 Input Data:

The INTERSECTION tab in the GOAT application offers two input options:

  1. Check "Enter Node ID" and enter a NODE ID in the NODE ID text box.
  2. Uncheck "Enter Node ID" and follow the instructions below

Select the Borough of Street 1 or Intersection Name. GOAT automatically modifies the Borough of Street 2 to coincide with the Borough of Street 1 or Intersection Name. Enter the names of two streets at the intersection, in either order, in the boxes labeled Street 1 or Intersection Name and Street 2. If there are more than two streets at the intersection, you may identify the intersection by entering any pair of those streets. Except for three special cases discussed below, you may now submit your inquiry by pressing the Submit button or the ENTER key.

Special case 1: If the intersection you are submitting lies on a borough boundary, and the two streets whose names you have entered lie in different boroughs, then before pressing the Submit button or the ENTER key, but after selecting the Borough of First Street Name, you must select the Borough of Second Street Name. For example, the Brooklyn street Ridgewood Avenue intersects with the Queens street Rockaway Boulevard at the Brooklyn-Queens border. To submit an Intersection (Function 2) inquiry for this location, select Brooklyn as the Borough of Street 1 or Intersection Name, enter RIDGEWOOD AVE as the Street 1 or Intersection Name, select Queens as the Borough of Street 2, and then enter ROCKAWAY BLVD as Street 2. (If you enter the two street names in the other order, select the two boroughs accordingly.) Then press the Submit button or the ENTER key.

Special case 2: If the streets you have entered intersect at two different points, you must select a compass direction to identify which of the two intersections you are inquiring about. For example, to process the easternmost of the two intersections of Cromwell Crescent and Alderton Street in Queens, select EAST as the compass direction. If you submit an inquiry for a pair of streets that intersect twice without having selected a compass direction, a message will inform you that a compass direction is required. If, on the other hand, you submit an inquiry for a pair of streets that intersect once and you have selected a compass direction, you will in addition to the output receive a warning message indicating that the compass direction is not required.

Special case 3: Certain street intersections have intersection names. For example, the intersection of West 54 Street and Broadway is known as "Big Apple Corner". For these special cases, you supply the intersection name in the field labeled Street 1 or Intersection Name and leave the field labeled Street 2 blank. If the Street 2 field is populated, GOAT will validate that the 2nd street does intersect at the named intersection. If yes, a warning message is returned (NON-INTERSECTION NAME IGNORED). However, if the name entered in the 2nd street field does not intersect at the named intersection the input is rejected (W 154 ST NOT PART OF BIG APPLE CORNER). Please note that "Times Square" is not an intersection name, because it refers to an area which includes several intersections.

The pseudo-street names BEND, DEAD END and CITY LIMIT can be used as input street names to specify bending points of streets, dead ends, and intersections of streets with the city limit, respectively.

Examples:

To submit a Function 2 inquiry for the bending point of Commerce Street in Manhattan, enter COMMERCE STREET as one of the input street names and BEND as the other input street name.

A dead end is a termination point of a street at which there are no cross streets. For example, Croes Avenue in the Bronx has a dead end near where it intersects with Watson Avenue. To submit a Function 2 inquiry for this dead end, enter CROES AVENUE as one of the input street names and DEAD END as the other input street name.

Linden Boulevard in Queens intersects with the city limit (in this case, the Queens-Nassau County border). To submit a Function 2 inquiry for this intersection, enter LINDEN BOULEVARD as one of the input street names and CITY LIMIT as the other input street name.

Unlike ADDRESS (Function 1), INTERSECTION (Function 2) does not allow you to enter a place name as input.


STREET SEGMENT (Function 3) Help

STREET SEGMENT (Function 3) accepts an input street segment (the portion of a street between two consecutive cross streets), and returns related geographic information. If you are only interested in information for one side of the street segment (Block Face), you must supply a compass direction. The information returned includes administrative and political district identifiers for the left and/or right side of the segment and the names of any additional cross streets that are present at the two endpoints of the segment.

Instructions for Entering Function 3 Input Data:

Select the Borough of the On Street Name. GOAT automatically modifies the Borough of First Cross Street and Second Cross Street to coincide with the Borough of the On Street. Enter the names of the three streets, which define the segment. The first street name entered is the On Street and the next two represent one of the cross streets at each end of the segment. Except for the special case discussed below, you may now submit your inquiry by pressing the Submit button or the ENTER key.

If the segment you are submitting involves streets that are in two boroughs, then before pressing the Submit button or the ENTER key, you will have to modify the Borough information. If the street segment lies on a borough boundary and one or both of the cross streets are in a different borough, then you will have to modify the Borough for the First and/or Second Cross Street. An example of the situation would be the street segment Eldert Lane in Queens with Cross Streets Etna Street and Ridgewood Avenue in Brooklyn. In this case, you would set the Borough for the On Street to Queens and the Borough for the First and Second Cross Streets to Brooklyn. Then press the Submit button or the ENTER key.

Another possibility is that one of the Cross Streets lies in a different borough. An example of this would be the street segment Ridgewood Avenue in Brooklyn with Cross Streets 90 Avenue in Queens and Grant Avenue in Brooklyn. In this case, you would set the Borough for the ‘On' Street to Brooklyn, the Borough for the First Cross Street to Queens and the Borough for the Second Cross Street to Brooklyn. Then press the Submit button or the ENTER key.

The pseudo-street names BEND, DEAD END and CITY LIMIT can be used as cross street names when defining a segment. In addition CITY LIMIT may be used as an ‘On' Street name in Queens and the Bronx

To submit a Function 3 inquiry that includes the bending point of Commerce Street in Manhattan, enter COMMERCE STREET as the ‘On' Street and BEND as one of the cross street names and either BEDFORD STREET or BARROW STREET as the other cross street name.

A dead end is a termination point of a street at which there are no cross streets. For example, Croes Avenue in the Bronx has a dead end near where it intersects with Watson Avenue. To submit a Function 3 inquiry that includes the dead end, enter CROES AVENUE as the ‘On' street names and DEAD END as one of the other cross street names and WATSON AVENUE as the other cross street name.

Linden Boulevard in Queens intersects with the city limit (in this case, the Queens-Nassau County border). To submit a Function 3 inquiry that includes the city boundary,enter LINDEN BOULEVARD as the On street name and CITY LIMIT as one of the cross street names and X ISLE PARKWAY ENTRANCE NB as the other street name.

In Queens, CITY LIMIT may be specified as the On Street and 41 AVENUE and 41 DRIVE may be specified as the cross street names. The information returned will be only for the Queens side of the county border. No information will be returned for the Nassau side of the county border.

Place names may not be used for either On street or Cross Street names in a STREET SEGMENT (Function 3) call.


STREET STRETCH (Function 3S) Help

Function 3S accepts as input a street stretch and returns the cross streets along the stretch. You may supply an On Street alone or an On Street and two cross streets, which will limit the amount of data returned. If you elect to supply cross streets and if either or both cross streets intersect the On Street exactly twice, you must supply a compass direction to determine which intersection you want selected. If one or both of the cross streets intersect the On Street more than twice, an error message will be returned indicating this problem and no data will be returned. If, on the other hand, you supply a compass direction and the On Street and cross street intersect once, in addition to the appropriate output, you will receive a warning message indicating that the compass direction was not required.

Instructions for Entering STREET STRETCH (Function 3S) Input Data:

All streets supplied must be in the same borough.

Enter the names of the On Street and, if you choose, the two cross streets as well as the relevant compass directions if either of the cross streets intersect the On Street exactly twice. You may now submit your inquiry by pressing the Submit button or the ENTER key.

The pseudo-street names BEND and DEAD END cannot be used as the On Street in a Function 3S call, but they may be used as cross street names when defining a segment. CITY LIMIT can be used as both an On Street and a cross street in Queens and the Bronx.

Examples:

To submit a Function 3S inquiry that includes the bending point of Commerce Street in Manhattan, enter COMMERCE STREET as the On Street and BEND as one of the cross street names and either BEDFORD STREET or BARROW STREET as the other cross street name. In general, using BEND as a cross street may be difficult because a street stretch may have more than two bending points.

A dead end is a termination point of a street at which there are no cross streets. For example, Croes Avenue in the Bronx has a dead end near where it intersects with Watson Avenue. To submit a Function 3S inquiry that includes the dead end, enter CROES AVENUE as the On Street name and DEAD END as one of the cross street names and, say, STORY AVENUE as the other cross street name. Using DEAD END as a cross street may be hard since a street stretch may have multiple dead ends.

Linden Boulevard in Queens intersects with the city limit (in this case, the Queens-Nassau County border). To submit a Function 3S inquiry that includes the city boundary, enter LINDEN BOULEVARD as the On Street name and CITY LIMIT as one of the cross streets and, say, FRANCIS LEWIS BOULEVARD as the other cross street.

Place names may not be used for either ‘On' street or Cross Street names in a Function 3S call.

There is also an option to ‘Show Real Streets Only’, which is set by default. This option returns the names of cross streets along a stretch, and will not return items defined as “Non-Street Feature” or “Bend”.


BLOCK & LOT (Function BL) Help

The input data to BLOCK & LOT (Function BL) is a Borough, Tax Block and Tax Lot. The information returned is property -specific and building -specific.

In addition to the ‘fixed' data returned, you have a choice of receiving a list of up to twenty one addresses which applies to the property and/or a list of BINs (Building Identification Numbers) that reside on the property.

The TPAD (Transitional Property Address Directory) option allows you to get up-to-date property related information. The TPAD file is updated daily with new information received from the Department of Buildings regarding job filings for new buildings and demolition jobs. Information regarding activity and status is returned.

Instructions for Entering BLOCK & LOT (Function BL) Input Data:

As input data to Function BL, you must select a Borough, and enter the Tax Block and the Tax Lot numbers. The Tax Block is a five digit number and the Tax Lot is a four digit number. Leading zeros need not be entered. If you select ‘BIN List', you will receive a list of BINs as part of your output. If you do not select ‘BIN List', you will receive a list of up to twenty one addresses which apply to the property. For some properties, there are more than twenty one addresses. In these situations, in addition to the twenty one addresses, you will receive a warning message indicating that the lot has more addresses than are displayed.


BIN (Function BN) Help:

The input data to Function BN is a Building Identification Number (BIN). The information returned is building-specific and property-specific and represents information about the single building.

In addition to the ‘fixed' data returned, you will receive a list of addresses which applies to the input BIN. The list of addresses should be complete because at this time no single building has more than twenty one addresses.

The TPAD (Transitional Property Address Directory) option allows you to get up-to-date property related information. The TPAD file is updated daily with new information received from the Department of Buildings regarding job filings for new buildings and demolition jobs. Information regarding activity and status is returned.

Instructions for Entering Function BN Input Data:

As input data to Function BN, you must enter the building identification number only. The building identification number is seven digits in length. The first digit must either be 1, 2, 3, 4 or 5. The second digit must not be either an 8* or a 9**. If you are looking for a BIN that only exists in the TPAD file, then you must select the TPAD option.

*BINs with a second digit of 8 reference ‘dummy’ BINs in the Department of Buildings BIS (Building Information System) and are not retrievable through GOAT.

**BINs with a second digit of 9 refer to an obsolete BIN that was used to indicate multiple structures. BINs with this numbering scheme are no longer assigned.


STREET (Name / Code) Help:

This function allows for a variety of options. A user can enter a street name, a street code, browse the Street Name Dictionary (SND), or normalize a street name. The term ‘street name’ is used generically to encompass not only names of city streets, but also a wide variety of other New York City geographic feature names including some tunnels, bridges, rail lines and place names. The terms ‘street name’ and ‘geographic feature name’ are used interchangeably.

There are options to set the street name length, to choose Sort or Compact format, and normalize the input street name to return the primary, principal or preferred name. Output, depending on the options chosen, includes Borough, Street Name, Street Code and Geographic Feature Type.

General Instructions and Information regarding Street Name / Code:

The Department of City Planning maintains a set of names of geographic features that Geosupport (the software behind GOAT) recognizes and considers valid. All of these names are assigned Street Codes. Street codes enable street name aliases to be grouped together in a meaningful way via the 5 digit or 7 digit street code. Each 10 digit street code is unique to a specific spelling variation of a street.

It is important to note that New York City geographic names are meaningful only when the borough is identified, since features in different boroughs can have the same name. For example, all five boroughs have a street named BROADWAY.

All geographic feature names are stored in a standardized or ‘normalized’ format, but the software will interpret data entered and “normalize” it for the user. The normalizing algorithm is quite complex and is beyond the scope of this user guide, but some notable characteristics are as follows:

  • Ordinal suffixes are absent. Ordinal suffixes are the endings ‘st’, ‘nd’, ‘rd’ and ‘th’ often used at the ends of numeric street names such as ‘71st’, ‘42nd’, ‘23rd’, and 108th’.
  • Standard street endings are abbreviated (such as ST for Street, RD for Road, E for East, etc.) only to the minimum extent necessary to enable names to fit within the Street Name Length specified by the user. The minimum Street Name Length is 4 and the maximum is 32. All geographic feature names in the system are normalized within the 32 byte limit.
  • The character set used for names consists of the letters of the alphabet, the numeric digits 0 through 9, and the characters dash ( - ), slash ( / ), ampersand ( & ) and apostrophe ( ‘ ).

The type of geographic feature associated with each name is identified by the geographic feature type:

  • The names of New York City's streets (including highways), tunnels and bridges
  • Certain pseudo-street names, including BEND, CITY LIMIT and DEAD END, and certain Duplicate Address Pseudo-Street names (DAPS’s), such as HILLSIDE AVENUE DOUGLASTON
  • The names of certain non-street features, including some rail lines and shorelines
  • Selected place names, of which there are three types:
    1. Addressable place names are place names that can be combined with address numbers to form addresses. Examples: the Manhattan names FEDERAL PLAZA and PENN PLAZA. Examples of the use of these names in addresses:

      26 FEDERAL PLAZA, 2 PENN PLAZA.

    2. Non-Addressable Place names (NAPs) are place names that historically could not be combined with address numbers to form addresses. Typical NAPs include the names of islands, parks, airports, bodies of water, building complexes, major named individual buildings etc. Examples: the Manhattan names EMPIRE STATE BUILDING and CITY HALL, and the Queens name LA GUARDIA AIRPORT. Note that some NAPs (such as EMPIRE STATE BUILDING) refer to buildings that also have conventional street addresses.

      In recent years, addresses have been assigned to buildings that use the NAP name, often in a different location from the NAP itself. An example in Manhattan is the NAP called ‘Bryant Park’. There is a building ‘One Bryant Park’ which users typically enter as ‘1 Bryant Park’. Another example is a NAP in Brooklyn called ‘Grand Army Plaza’. A cooperative now exists nearby and its address is ‘1 Grand Army Plaza’.
      If a NAP name is entered into GOAT along with an address, the application will ignore the house number if it does not exist in the underlying data.

    3. Intersection Names are names given to the intersection of two or more streets usually but not necessarily by the City Council. Intersection Names allow an intersection to be identified using one input “street” name instead of two as is currently required. BEN KIMMEL SQUARE in the Bronx is an example of an Intersection Name.

Many geographic features have two or more aliases, or alternate names, or spelling variants of the same name. One common case of aliases is names containing a numeric word between 1 and 10; these are all represented with two different spellings; with the numeric word expressed in digits (such as 6 Avenue) and with the numeric word spelled out alphabetically (Sixth Avenue).ue) and with the numeric word spelled out alphabetically (Sixth Avenue).

The following are examples of various types of aliases:

  • SIXTH AVENUE and AVENUE OF THE AMERICAS are aliases, since they are alternative names for the same street.
  • SEVENTH AVENUE, FASHION AVENUE and ADAM POWELL JR BOULEVARD are aliases, since they are alternative names for the same street or (in the latter two cases) parts thereof.
  • SIXTH AVENUE and 6 AVENUE are aliases, since they are spelling variants of the same street name. Other examples of spelling variant aliases are MAC DOUGAL STREET, MC DOUGAL STREET and MCDOUGAL STREET; BEN-GURION PLACE, BEN GURION PLACE and BENGURION PLACE; ST MARKS PLACE, SAINT MARKS PLACE and SAINT MARK’S PLACE; and (in the Bronx) O’BRIEN AVENUE, OBRIEN AVENUE and O BRIEN AVENUE.

The existence of an alias relationship between two names stored in the system can be readily identified from their street codes: Two names are aliases if and only if the first six bytes of their B10SC’s, known as the Borough-and-5-digit Street Codes (B5SC’s), are identical . It can also be readily determined whether two aliases for a geographic feature are valid for the same part (possibly all) of the feature: Two names are valid for the same part (possibly all) of a feature if and only if the first eight bytes of their B10SC’s, known as the Borough-and-7-digit Street Codes (B7SC’s), are identical .

For example, SEVENTH AVENUE, 7 AVENUE, FASHION AVENUE and ADAM POWELL JR BOULEVARD in Manhattan are all aliases, so their street codes all have the same B5SC value. In addition, SEVENTH AVENUE and 7 AVENUE are valid for the same part of the street (in this case, the entire street), so they have the same B7SC value. FASHION AVENUE is valid for a different part of the street (the portion in the Garment District of Midtown), so it has a different B7SC value. ADAM POWELL JR BOULEVARD is valid for yet a different part of the street (the portion north of Central Park), so it has yet a different B7SC value. In the case of a complex (such as Lincoln Center) and its constituent entities, the assignment of street codes is structured analogously to that just described for streets. The names of the entire complex and the names of its constituent entities are all treated as aliases of each other, since they are all names of the same geographic feature (the entire complex) or parts thereof (the constituent entities of the complex). “Being treated as aliases” means that the B10SC’s assigned to these names all have the same B5SC value. Within the umbrella of this B5SC value, the entire complex has its own distinct B7SC value and each constituent entity has its own distinct B7SC value. For example, all of the names for Manhattan’s Lincoln Center complex and its constituent entities have the same B5SC value. In addition, LINCOLN CENTER and LINCOLN CENTER FOR THE PFMG ARTS are alternative names of the same part of the complex (in this case the entire complex), so these two names have the same B7SC value. AVERY FISHER HALL and PHILHARMONIC HALL are alternative names of the same part of the complex (in this case, a particular building), so these two names have the same B7SC value, which differs from the B7SC values assigned to the names of the entire complex and to the names of the complex’s other constituent entities.

Users should also understand the difference between SORT and COMPACT Format. The sole difference between these two formats is the presence or absence of alignment blanks for names containing numeric characters. A conventional method of displaying streets names is called the Compact Format because it does not contain leading blanks before numeric street names. The Sort Format is more suitable for listing street names for display or in a report because street names will ‘sort’ logically: names will ‘sort’ logically:

SORTED LIST IN COMPACT FORMAT SORTED LIST IN SORT FORMAT
EAST HOUSTON STREET bbb5 AVENUE
EAST 1 STREET bb10 AVENUE
EAST 10 STREET EAST bbb1 STREET
EAST 102 STREET EAST bbb2 STREET
EAST 129 STREET EAST bbb3 STREET
EAST 13 STREET EAST bbb9 STREET
EAST 167 STREET EAST bb10 STREET
EAST 2 STREET EAST bb13 STREET
EAST 20 STREET EAST bb20 STREET
EAST 201 STREET EAST bb79 STREET
EAST 3 STREET EAST b102 STREET
EAST 79 STREET EAST b129 STREET
EAST 9 STREET EAST b167 STREET
FULTON STREET EAST b201 STREET
10 AVENUE EAST HOUSTON STREET
5 AVENUE FULTON STREET

As this example illustrates, in the compact format, normalized street names do not sort appropriately. For example, EAST 10 STREET sorts in front of EAST 9 STREET, and 10 AVENUE sorts in front of 5 AVENUE. In contrast, in the sort format, the presence of the alignment blanks causes street names containing numeric characters to sort appropriately. Notice that the presence of the alignment blanks in the sort format (shown as b in the example), and their absence in the compact format, causes a change to the sort order of numeric street names not only relative to each other, but also relative to non-numeric street names. For example, in the compact format, FULTON STREET sorts in front of street names that begin with a numeric character, such as 10 AVENUE, while in the sort format it sorts behind them. Similarly, in the compact format, EAST HOUSTON STREET sorts in front of the street names that start with the word EAST followed by a numeric word, while in the sort format, it sorts behind those street names.

For more information regarding street names and street codes, please refer to our User Programming Guide, Chapters III - Street Name Processing & IV - Street Codes

Instructions for Entering STREET (Name / Code) data:

The STREET (Name / Code) tab in the GOAT application offers a variety of options:

  1. Convert Street Name to Street Code: Select a Borough from the dropdown list and enter a street name. You have the additional options of selecting a Street Name Length between 4 and 32 (the default is 32), or specifying Sort vs. Compact Format (the default is Sort). Hit the Submit button. The information returned is the Street Name in normalized format, the Borough 10 digit street code (B10SC) and the Geographic Feature Type.

  2. Convert Street Code to Street Name (D, DG, DN): Enter up to 3 street codes (B5SC, B7SC or B10SC). You have the additional options of selecting a Street Name Length between 4 and 32 (the default is 32), or specifying Sort vs. Compact Format (the default is Sort). Hit the Submit button. The information returned is the Borough, the Street Name in normalized format, the Borough 10 digit street code (B10SC) and the Geographic Feature Type.

    Note that if you choose to enter up to 3 street codes, they all must be the same format; you must enter either all B5SCs, allB7SCs or all B10SCs. If you enter an optional second or third street code, the software expects those to be in the same format that you entered the first street code. Therefore, if you enter a B5SC in the first field and a B7SC in the second field, GOAT will ignore the last two digits supplied in the B7SC. If on the other hand you enter a B7SC in the first field and a B5SC in the second or third field, GOAT will treat this as an error.

  3. Normalize Input Street Name (N*): Enter up to 3 street names that are not necessarily recognized by the system (i.e. either do not exist or have not been assigned street codes). You have the additional options of selecting a Street Name Length between 4 and 32 (the default is 32), or specifying Sort vs. Compact Format (the default is Sort). Hit the Submit button. The information returned is the street name(s) in normalized format.

  4. Browse Street Name Dictionary (BB, BF): Select a borough from the dropdown list and enter a street name. You have the additional option to normalize the input street name as the input street, the primary street name (as per the B5SC), the principal street name (as per the B7SC) or the preferred street name. Hit the Submit button. Please note that there is no Sort vs. Compact option available in this function. The output will always be in sort format.

Version Info (Function HR) Help:

Invoke Function HR to view the current version of the files in use. On WebGOAT, the release version will be in a heading at the top of the page, above the table.

No input data is required to view the version info. Simply click the tab on the navigation bar and you will get the current file data.

The columns of the data table are as follows:

  1. DDName - The data definition name for the file. This name is required by Geosupport on all platforms: mainframe, Windows, and LINUX.
  2. Release - The release cycle in which this data file was last updated as part of a release. It is very important to note that not all files will be the same release cycle, nor will they all have the current release cycle. Updates to each file follow their own set of protocols, and their displayed release cycle reflects this.
  3. Date - The date of the last update in yyMMdd format. This date will always be in range of its corresponding release cycle from the previous column.