Site Index Contact Login Sign up RSS
Texas A&M Geography
Geocoding Web Service

The Texas A&M Geoservices Geocoder can be used from desktop and/or web applications via the Geocoding Web Service interfaces listed below. The only required information is the API key, which is available in your account profile page. You may want to read the technical details and the known bugs.

API Version - 3.01

    - Previous versions - 2.96

Available Advanced Web Services


The following web services provide a really really lot of metadata about the internal working of the WebGIS Geocoder. These APIs offer enhanced input parameter options and output values compared to the basic Geocoding APIs.

The APIs listed on this papge allow you to review metadata about the internal working of the Texas A&M Geoservices Geocoder as well as choose advanced options for requesting specific computational options, reference data sources, output hierarchies, etc. (i.e., all the science under the hood).

Most people probably don't need or care about the internal workings of geocoding systems, but they are provided here in hopes that more people start to! If you are scared, you can return to the simpler versions of the API's by clicking here.



API #3 - HTTP Geocode Detailed Web Service (Non-parsed)


  • API for non-parsed address data that can be used from scripts and http
  • API URL

    https://geoservices.tamu.edu/Services/Geocode/WebService/GeocoderWebServiceHttpNonParsedDetailed_V03_01.aspx?

    API Input Fields

    (* Fields in bold are new for this API version)
    Parameter Required Description Example Possible Value
    apiKey true Click here for your API key api-key-value some text
    version true api version 3.01 3.01
    streetAddress false non-parsed street address value 3620 North Vermont Ave W. some text
    city false city value Beverly Hills some text
    state false state value CA some text
    zip false zip code value 90089 some text
    census false calculate census variables (takes longer) true true, false
    censusYear false the year of census data to intersect with 2010 1990, 2000, 2010
    geom false return the full geometry of the reference feature (creates a very large response) true true, false
    verbose false output full details true true, false
    format false output format csv csv, (results in comma separated values)
    tsv, (results in tab separated values)
    xml, (results in XML format)
    kml, (results in a KML file)
    googleMapsUrl, (results in a URL to show the output in Google Maps)
    includeHeader* false include column headers for text (csv/tsv) output true true (include field headers)
    false (don't include field headers)
    notStore false indicates if the transaction details should not be historically stored in your account true true, false

    API Output Fields and Index (for non-XML output)

    (* Fields in bold are new for this API version)
    Position Field Required Description Possible Values
    0 Transaction Id true Query Id Unique Id
    1 API Version true Vesion of the API used 3.01
    2 Query Status Code true Result code See list
    3 Latitude true Decimal
    4 Longitude true Decimal
    5 NAACCR GIS Coordinate Quality Code* true Geocode quality code in NAACCR standard See list
    6 NAACCR GIS Coordinate Quality Name* true Name of the geocode quality code in NAACCR standard See list
    7 Match Score true Match percentage between input data and reference feature
    8 Match Type true Geocode match type See list
    9 Matching Geography Type true Geographic level of the output See list
    10 Spatial Uncertainty Area* true Area of spatial uncertainty of the geocode decimal number
    11 Spatial Uncertainty Area Type* true Units of area of spatial uncertainty of the geocode square meters (m), square kilometers (km)
    12 Interpolation Type true Interpolation method used See list
    13 Interpolation Sub-Type true Interpolation sub-method used See list
    14 Matched Location Type true Type of input data identified See list
    15 Feature Matching Result Type true Result of the feature matching algorithm See list
    16 Feature Matching Result Count true Number of features returned from feature matching algorithm
    17 Feature Matching Result Type Notes true Notes about the feature matching processing results
    18 Tie Handling Strategy Type true Tie breaking strategy used in feature matching See list
    19 Feature Matching Result Type Tie Breaking Notes true Notes about the tie breaking results
    20 Feature Matching Selection Method true Feature matching selection method used See list
    21 Feature Matching Selection Method Notes true Notes about the feature matching selection method used
    22 Time Taken true Processing time Milliseconds
    23 Census Year true Year of the census data returned NineteenNinety, TwoThousand, TwoThousandTen, AllAvailable
    24 NAACCR Census Tract Certainty Code* true Centainty code for the Census tract assignment in NAACCR standard See list
    25 NAACCR Census Tract Certainty Name* true Name of the centainty code for the Census tract assignment in NAACCR standard See list
    26 Census Block false Census block value for the output point
    27 Census Block Group false Census block group value for the output point
    28 Census Tract false Census tract value for the output point
    29 Census County Fips false Census county fips value for the output point
    30 Census CBSA Fips false Census core base statistical area fips value for the output point
    31 Census CBSA Micro false Census core base statistical area micropolitan flag for the output point
    32 Census MCD Fips false Census minor civil division fips value for the output point
    33 Census MetDiv Fips false Census metropolitan division fips value for the output point
    34 Census MSA Fips false Census metropolitan statistical area fips value for the output point
    35 Census Place Fips false Census place fips value for the output point
    36 Census State Fips false Census state fips value for the output point
    37 MNumber false Street number of the address that matched
    38 MNumberFractional false Street number fractional of the address that matched
    39 MPreDirectional false Street predirectional of the address that matched
    40 MPreQualifier false Street prequalifier of the address that matched
    41 MPreType false Street pretype of the address that matched
    42 MPreArticle false Street prearticle of the address that matched
    43 MName false Street name of the address that matched
    44 MPostArticle false Street postarticle of the address that matched
    45 MPostQualifier false Street postqualifier of the address that matched
    46 MSuffix false Street suffix of the address that matched
    47 MPostDirectional false Street postdirectional of the address that matched
    48 MSuiteType false Suite type of the address that matched
    49 MSuiteNumber false Suite number of the address that matched
    50 MPostOfficeBoxType false Post office box type of the address that matched
    51 MPostOfficeBoxNumber false Post office box number of the address that matched
    52 MCity false City of the address that matched
    53 MConsolidatedCity false Consolidated city of the address that matched
    54 MMinorCivilDivision false Minor civil division of the address that matched
    55 MCountySubRegion false County sub region of the address that matched
    56 MCounty false County of the address that matched
    57 MState false State of the address that matched
    58 MZip false Zip of the address that matched
    59 MZipPlus1 false Zip+1 of the address that matched
    60 MZipPlus2 false Zip+2 of the address that matched
    61 MZipPlus3 false Zip+3 of the address that matched
    62 MZipPlus4 false Zip+4 of the address that matched
    63 MZipPlus5 false Zip+5 of the address that matched
    64 PNumber false Street number of the parsed address
    65 PNumberFractional false Street number fractional of the parsed address
    66 PPreDirectional false Street predirectional of the parsed address
    67 PPreQualifier false Street prequalifier of the parsed address
    68 PPreType false Street pretype of the parsed address
    69 PPreArticle false Street prearticle of the parsed address
    70 PName false Street name of the parsed address
    71 PPostArticle false Street postarticle of the parsed address
    72 PPostQualifier false Street postqualifier of the parsed address
    73 PSuffix false Street suffix of the parsed address
    74 PPostDirectional false Street postdirectional of the parsed address
    75 PSuiteType false Suite type of the parsed address
    76 PSuiteNumber false Suite number of the parsed address
    77 PPostOfficeBoxType false Post office box type of the parsed address
    78 PPostOfficeBoxNumber false Post office box number of the parsed address
    79 PCity false City of the parsed address
    80 PConsolidatedCity false Consolidated city of the parsed address
    81 PMinorCivilDivision false Minor civil division of the parsed address
    82 PCountySubRegion false County sub region of the parsed address
    83 PCounty false County of the parsed address
    84 PState false State of the parsed address
    85 PZip false Zip of the parsed address
    86 PZipPlus1 false Zip+1 of the parsed address
    87 PZipPlus2 false Zip+2 of the parsed address
    88 PZipPlus3 false Zip+3 of the parsed address
    89 PZipPlus4 false Zip+4 of the parsed address
    90 PZipPlus5 false Zip+5 of the parsed address
    91 FNumber false Street number of the matched reference feature
    92 FNumberFractional false Street number fractional of the matched reference feature
    93 FPreDirectional false Street predirectional of the matched reference feature
    94 FPreQualifier false Street prequalifier of the matched reference feature
    95 FPreType false Street pretype of the matched reference feature
    96 FPreArticle false Street prearticle of the matched reference feature
    97 FName false Street name of the matched reference feature
    98 FPostArticle false Street postarticle of the matched reference feature
    99 FPostQualifier false Street postqualifier of the matched reference feature
    100 FSuffix false Street suffix of the matched reference feature
    101 FPostDirectional false Street postdirectional of the matched reference feature
    102 FSuiteType false Suite type of the matched reference feature
    103 FSuiteNumber false Suite number of the matched reference feature
    104 FPostOfficeBoxType false Post office box type of the matched reference feature
    105 FPostOfficeBoxNumber false Post office box number of the matched reference feature
    106 FCity false City of the matched reference feature
    107 FConsolidatedCity false Consolidated city of the matched reference feature
    108 FMinorCivilDivision false Minor civil division of the matched reference feature
    109 FCountySubRegion false County sub region of the matched reference feature
    110 FCounty false County of the matched reference feature
    111 FState false State of the matched reference feature
    112 FZip false Zip of the matched reference feature
    113 FZipPlus1 false Zip+1 of the matched reference feature
    114 FZipPlus2 false Zip+2 of the matched reference feature
    115 FZipPlus3 false Zip+3 of the matched reference feature
    116 FZipPlus4 false Zip+4 of the matched reference feature
    117 FZipPlus5 false Zip+5 of the matched reference feature
    118 FArea false Area of the matched feature
    119 FAreaType false Area metric of the matched feature
    120 FGeometrySRID false Geometry SRID of the matched feature
    121 FGeometry false Geometry of the matched feature as OGC GML
    122 FSource false Source of the matched feature
    123 FVintage false Vintage of the matched feature
    124 FPrimaryIdField false Name of the primary Id field of the matched feature
    125 FPrimaryIdValue false Value of the primary Id field of the matched feature
    126 FSecondaryIdField false Name of the secondary Id field of the matched feature
    127 FSecondaryIdValue false Value of the secondary Id field of the matched feature

    Notes
    - M____: The attribute value of your input address that used in finding a reference feature
    - P____: The equivalent parsed attribute value of your input address
    - F____: The attribute value of the matched reference feature used for interpolation


API #4 - HTTP Geocode Detailed Web Service (Non-parsed) with Advanced Options


  • API for non-parsed address data that can be used from scripts and http that allows advanced options to be specified
  • API URL

    https://geoservices.tamu.edu/Services/Geocode/WebService/GeocoderWebServiceHttpNonParsedAdvanced_V03_01.aspx?

    API Input Fields

    This API's input field set includes all of the input and output parameters from API #2 above with the additions in the following table. Each of these are described in the techincal details. The default values used here are automatically used in API #2 above.

    Parameter Required Description Values Default value
    r false whether or not to use attribute relaxation true, false true
    ratts false the attributes allowed to be relaxed; only applies if shouldUseRelaxation is true comma separated list from the following options: pre, suffix, post, city, zip pre,suffix,post,city,zip
    sub false whether or not to use substring matching true, false true
    sou false whether or not to use soundex true, false true
    souatts false the attributes allowed to be soundex'ed; only applies if shouldUseSoundex is true comma separated list from the following options: name, city name,city
    h false which feature matching hierarchy to use uncertaintyBased, u, FeatureMatchingSelectionMethod, f, FeatureMatchingSelectionMethod
    refs false which reference data sources to use all

    - or one or more of the following -

    countyParcelData,
    OpenAddresses,
    navteqAddressPoints2017,
    navteqAddressPoints2016,
    navteqAddressPoints2014,
    navteqAddressPoints2013,
    navteqAddressPoints2012,
    parcelCentroids,
    boundarySolutionsParcelCentroids,
    parcelGeometries,
    navteqStreets2012,
    navteqStreets2008,
    tiger2016,
    tiger2015,
    tiger2010,
    zipPlus4,
    census2010Places,
    census2008Places,
    census2000Places,
    census2010ConsolidatedCities,
    census2008ConsolidatedCities,
    census2000ConsolidatedCities,
    census2000MCDs,
    census2010ZCTAs,
    census2008ZCTAs,
    census2000ZCTAs,
    zcdZips2013,
    census2010CountySubRegions,
    census2008CountySubRegions,
    census2000CountySubRegions,
    census2010Counties,
    census2008Counties,
    census2000Counties,
    census2010States,
    census2008States
    all

    API Output Fields and Index (for non-XML output)

    The output fields for this API are the same as API #3 above

Quick Links: Home | Services | Databases | Support | About | Site Map | Contact