Addressing API: Enabling Preferences

Scenario

Use the Geocode Service with Delivery Point Validation (DPV) and SuiteLink preferences enabled.

Request

{
  "preferences": {
    "maxResults": 1,
    "returnAllInfo": true,
    "factoryDescription": {
      "label": "",
      "featureSpecific": {}
    },
    "customPreferences": {
     "FIND_DPV": "true",
     "FIND_SUITELINK": "true"
    }
  },
  "addresses": [
    {
      "addressLines": [
        "2502 N ROCKY POINT DR"
      ],
      "country": "USA",
      "addressNumber": "",
      "admin1": "FL",
      "admin2": "",
      "city": "Tampa",
      "postalCode": "33607",
      "postalCodeExt": "",
      "placeName": "DRAKE BEAM"
    }
  ]
}

Response

{
  "responses": [
    {
      "status": "OK",
      "results": [
        {
          "score": 100,
          "address": {
            "formattedAddress": "DRAKE BEAM, 2502 ROCKY POINT DR STE 890, TAMPA FL 33607-5994",
            "formattedStreetAddress": "2502 N ROCKY POINT DR STE 890",
            "formattedLocationAddress": "TAMPA, FL  33607-5994",
            "addressNumber": "2502",
            "country": {
              "isoAlpha3Code": "USA"
            },
            "admin1": {
              "longName": "FL",
              "shortName": "FL"
            },
            "admin2": {
              "longName": "HILLSBOROUGH COUNTY",
              "shortName": "HILLSBOROUGH COUNTY"
            },
            "city": {
              "longName": "TAMPA",
              "shortName": "TAMPA"
            },
            "neighborhood": {},
            "postalCode": "33607",
            "postalCodeExt": "5994",
            "placeName": "DRAKE BEAM",
            "unit": "890",
            "unitType": "STE",
            "street": "ROCKY POINT"
          },
          "addressLines": [
            "DRAKE BEAM",
            "2502 ROCKY POINT DR STE 890",
            "TAMPA FL 33607-5994"
          ],
          "location": {
            "explanation": {
              "type": "ADDRESS_POINT"
            },
            "feature": {
              "type": "Feature",
              "properties": {
                "crsName": "epsg:4326"
              },
              "geometry": {
                "type": "Point",
                "coordinates": [
                  -82.571057,
                  27.962831
                ]
              }
            }
          },
          "explanation": {
            "addressMatch": {
              "type": "ADDRESS",
              "description": [
                {
                  "label": "placeName",
                  "matchType": "NONE"
                },
                {
                  "label": "addressNumber",
                  "matchType": "EXACT"
                },
                {
                  "label": "admin1",
                  "matchType": "EXACT"
                },
                {
                  "label": "admin2",
                  "matchType": "NONE"
                },
                {
                  "label": "city",
                  "matchType": "EXACT"
                },
                {
                  "label": "neighborhood",
                  "matchType": "NONE"
                },
                {
                  "label": "suburb",
                  "matchType": "NONE"
                },
                {
                  "label": "street",
                  "matchType": "EXACT"
                },
                {
                  "label": "postalCode",
                  "matchType": "EXACT"
                },
                {
                  "label": "streetType",
                  "matchType": "EXACT"
                },
                {
                  "label": "postalCodeExt",
                  "matchType": "NONE"
                },
                {
                  "label": "streetDirectional",
                  "matchType": "EXACT"
                }
              ]
            },
            "source": {
              "label": "ggs"
            }
          },
          "customFields": {
            "RESBUS": "B",
            "LOTSIZE_METERS": "21522",
            "TYPE_SHORT": "DR",
            "DPV_VACANT": "N",
            "THOROUGHFARE_TYPE": "DR",
            "DPV_NO_STAT": "N",
            "HIUNIT": "890",
            "PARCEN_ELEVATION_METERS": "1.6",
            "ROAD_CLASS": "01",
            "RDI_RETCODE": "N",
            "MATCH_CODE": "S800",
            "DPV_CONFIRM": "Y",
            "COUNTY": "12057",
            "PB_KEY": "P00005K7PTFV",
            "LANGUAGE": "en",
            "UNIT_TYPE": "STE",
            "INC_IND": "I",
            "ADDRTYPE": "M",
            "POINT_ID": "106197067",
            "CHECK_DIGIT": "8",
            "METRO_FLAG": "Y",
            "BLOCK": "120570117081024",
            "POST_THOROUGHFARE_TYPE": "DR",
            "QCITY": "120410000",
            "ZIP_FACILITY": "P",
            "TFID": "262540600",
            "UNIT_RANGE_PARITY": "E",
            "APN_ID": "172914ZZZ000005347100A",
            "LOT_CODE": "A",
            "LOT_NUM": "0122",
            "GEOHASH": "dhvr143x6ct2",
            "PREDIR": "N",
            "CTYST_KEY": "Y23079",
            "UACEPOP": "2441770",
            "ZIP_CARRTSORT": "D",
            "NAME": "ROCKY POINT",
            "SUITELINK_RET_CODE": "A",
            "CLOSE_MATCH": "T",
            "LORANGE": "2502",
            "MEC_LAT": "27962769",
            "STREET_SIDE": "L",
            "DPV_CMRA": "N",
            "DATATYPE": "12",
            "ZIP_CITY_DELV": "Y",
            "INTERSECTION": "F",
            "LOUNIT": "890",
            "LOC_CODE": "AP02",
            "MEC_RAD": "385",
            "CART": "C034",
            "NAME_CITY": "TAMPA",
            "BLOCK_LEFT": "120570117081024",
            "VALIDATION_CONFIDENCE": "97",
            "COUNTY_FIPS": "12057",
            "HIRANGE": "2502",
            "UACE": "86599",
            "MEC_RAD_METERS": "117.2",
            "REC_TYPE": "H",
            "HI_RISE_DFLT": "N",
            "URBANICITY": "L",
            "MEC_LON": "-82571091",
            "MATCH_TYPE": "ADDRESS",
            "RESOLVED_LINE": "0",
            "PARCEN_ELEVATION": "5",
            "ADDRESS_LINE1": "DRAKE BEAM",
            "ADDRESS_LINE2": "2502 ROCKY POINT DR STE 890",
            "ADDRESS_LINE3": "TAMPA FL 33607-5994",
            "PREF_CITY": "TAMPA",
            "CBSA_NUMBER": "45300",
            "ALT_FLAG": "B",
            "SEGMENT_DIRECTION": "F",
            "ADDRLINE_SHORT": "2502 N ROCKY POINT DR STE 890",
            "LOTSIZE": "231662",
            "CONFIDENCE": "100",
            "HIZIP4": "5994",
            "DATATYPE_NAME": "MASTER LOCATION",
            "SEGMENT_PARITY": "R",
            "LOZIP4": "5994",
            "PREDIR_SHORT": "N",
            "PLACE": "1271000",
            "DPBC": "15",
            "LASTLINE_SHORT": "TAMPA, FL  33607-5994",
            "DPV_SHUTDOWN": "N",
            "DPV_FOOTNOTE2": "BB",
            "DPV_FOOTNOTE1": "AA",
            "CITY_SHORT": "TAMPA",
            "NAME_SHORT": "ROCKY POINT",
            "ZIP9": "336075994",
            "IS_ALIAS": "N01",
            "PRECISION_CODE": "S8HPNTSCZA",
            "ZIP10": "33607-5994",
            "CBSA_NAME": "TAMPA-ST. PETERSBURG-CLEARWATER, FL METROPOLITAN STATISTICAL AREA",
            "RANGE_PARITY": "E"
          }
        }
      ]
    }
  ]
}