Method PostReadLandByAddress

Summary

Get Land File by Address

Remarks

Get Land File information by Address. The street name, number, direction, suffix, and other pre/post qualifiers must exactly match the location record to be retrieved.

Requires

Input Parameters

NameTypeLengthDescription
StreetNo numeric 7 Street number
StreetDir System.String 2 Street Direction. Ex. N, S, E, W, NE, NW
StreetName System.String 25 [Required] Street name
StreetSuffix System.String 4 Street Suffix. Ex. AVE, RD, CIR
StreetPostDir System.String 2 Street post directions.
StreetPreQual System.String 10 Street pre qualifier
StreetPostQual System.String 5 Street Post Qualifier, such as 'Suite' or 'Apt.'
Apartment System.String 5 Apartment number

Example

POST http://localhost/FusionServices/v2/NaviLine/Land/SearchByAddress

Return Values

NameDescription
Function Function command sent to retrieve the record. Internal use only.
Order Ordering code sent to retrieve the record. Internal use only.
Error Indicates if the record was found or not. 0=Found, 1=Not Found
LocationId Location ID of the land record.
StreetNo Street Number
StreetDir Street Direction. Ex. N, S, E, W, NE, NW
StreetName Street Name
Apartment Apartment Number
ZipCode Zip Code. Will include Zip+4 if available.
CarrierRoute 2 digit Carrier number and 2 digit Route number. Ex. 0104 = Carrier 1, Route 4
OwnerName Owner Name
OwnerType Owner Type. BO-Billable Owner, BP=Billable Party, L=Landlord, LH=Lien Holder, M=Management Company, P=Primary Owner. Blank=Primary Owner
OwnerAddress Owner address line 1
OwnerAddress2 Owner address line 2
OwnerAreaCode Owner telephone area code
OwnerPhoneNo Owner 7 digit phone number
ParcelNo1-10 Parcel number for the location. Each section returned separately.
ParcelType Parcel type. Blank=Address, I=Intersection, M=Main parcel, P=Parcel
AlternateId Alternate ID or Tax Number
StreetQualifier Street Qualifier
Acreage Acreage. Returned as 4 digit decimal.
PropertyCode Property Use Code
UndividedInterest Undivided Interest Percentage
TownshipCode Township Code. Indicates which town or district it is in.
InsideOutsideCode Inside Outside Code. Indicates if it is inside or outside of city limits.
CommissionerCode Commissioner Code
FormattedAddress Street number, name, direction, and suffix formatted into the address
StreetPostQual Street Post Qualifier, such as Suite or Apartment
StreetSuffix Street Suffix. Ex. AVE, RD, CIR
StreetPostDir Street post directions.
StreetPreQual Street pre qualifier
ParcelDeliveryPoint Parcel Delivery Point
OwnerDeliveryPoint Owner Delivery Point
GeneralLocationCode General Location Code
ParcelStatus Parcel Status Code
AddressType Address Type. BO-Billable Owner, BP=Billable Party, L=Landlord, LH=Lien Holder, M=Management Company, P=Primary Owner. Blank=Primary Owner
OwnerEffectiveDate Date owner address becomes affective. Format CYYMMDD
PlatBookPage Plat Book Page
UseZone Use Zone
FireZone Fire Zone
VarianceCode Variance Code
InspectionArea Inspection Area
Subdivision1 Subdivision 1
Subdivision2 Subdivision 2
Longitude11 Longitude 11 digit (old)
Latitude11 Latitude 11 digit (old)
OwnerDOB Owner Date of Birth
ExtendedAddress Extended Address
FreeFormAddress Free Form Address
RelatedPartyId Related Party Id
AddressStatus Address Status
AddressEffectiveDate Date address becomes affective. Format CYYMMDD
IntersectionStreet Intersection Street
IntersectionDir Intersection Direction
IntersectionSuffix Intersection Suffix
CensusTract7 Census Tract 7 digit (old)
ParcelSplitCode Parcel Split Code
Longitude15 Longitude 15 digit. Format: 4039902.560000
Latitude15 Latitude 15 digit. Format: 4039902.560000
MapX Map X coordinate
MapY Map Y coordinate
CensusTract11 Census Tract 11 digit
ErrorCode 0000=Successful. 0001=Not Found
ErrorMessage Description of result
Status Successful, Rejected, or Error

Sample Responses

Sample Code

using System.Net;

string uri = "http://localhost/FusionServices/v2/NaviLine/Land/ReadByAddress";
System.Collections.Specialized.NameValueCollection postParms = 
     new System.Collections.Specialized.NameValueCollection(); 

postParms.Add("StreetNo",System.Web.HttpUtility.UrlEncode("102"));
postParms.Add("StreetName",System.Web.HttpUtility.UrlEncode("FAIRY"));
postParms.Add("StreetSuffix",System.Web.HttpUtility.UrlEncode("AVE"));
using (WebClient req = new WebClient())
{
    byte[] responseBytes = wc.UploadValues(new Uri(uri), "POST", postParms);
    string stringResult = Encoding.UTF8.GetString(responseBytes); 
    // TODO
}

C# Razor MVC Sample Code

using System;
using System.Linq;
using System.Web;
using System.ComponentModel.DataAnnotations;
using System.Collections.Specialized;
using FusionServiceHelper.Models;

// NOTE: Use the namespace generated when you add the class, so that it is correct.
namespace FusionRazor.Models
{
   public class PostReadLandByAddress
   {
       // Add property for each input param in order to map a field to it
       [RegularExpression("[0-9]{0,7}", ErrorMessage = "Numeric values only. Must be 7 digits or less. ")]
       public string StreetNo{get; set;}

       [RegularExpression("^(?=.{0,2}$).*", ErrorMessage = "Must be 2 characters or less. ")]
       public string StreetDir{get; set;}

       [Required(ErrorMessage = "Required")]
       [RegularExpression("^(?=.{0,25}$).*", ErrorMessage = "Must be 25 characters or less. ")]
       public string StreetName{get; set;}

       [RegularExpression("^(?=.{0,4}$).*", ErrorMessage = "Must be 4 characters or less. ")]
       public string StreetSuffix{get; set;}

       [RegularExpression("^(?=.{0,2}$).*", ErrorMessage = "Must be 2 characters or less. ")]
       public string StreetPostDir{get; set;}

       [RegularExpression("^(?=.{0,10}$).*", ErrorMessage = "Must be 10 characters or less. ")]
       public string StreetPreQual{get; set;}

       [RegularExpression("^(?=.{0,5}$).*", ErrorMessage = "Must be 5 characters or less. ")]
       public string StreetPostQual{get; set;}

       [RegularExpression("^(?=.{0,5}$).*", ErrorMessage = "Must be 5 characters or less. ")]
       public string Apartment{get; set;}

       public PostReadLandByAddress()
       {
           //Set any defaults here
       }
   }
}
@* NOTE: Use Add->View to add the View. *@
@* NOTE: Check the 'Create strongly-typed view checkbox, and select the PostReadLandByAddress class. *@
@* NOTE: Select Edit as the Scaffold template. *@
@* NOTE: Use the @model line that is generated at the top.  Replace the rest with the lines below.
@model FusionRazor.Models.PostReadLandByAddress

@{
   ViewBag.Title = "PostReadLandByAddress";
}

<h2>PostReadLandByAddress</h2>
@using (Html.BeginForm()) {
   @Html.AntiForgeryToken()
   @Html.ValidationSummary(true)
   <fieldset>
   <legend>PostReadLandByAddress</legend>
       <div class="editor-label">
           @Html.LabelFor(model => model.StreetNo)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.StreetNo)
           @Html.ValidationMessageFor(model => model.StreetNo)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.StreetDir)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.StreetDir)
           @Html.ValidationMessageFor(model => model.StreetDir)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.StreetName)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.StreetName)
           @Html.ValidationMessageFor(model => model.StreetName)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.StreetSuffix)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.StreetSuffix)
           @Html.ValidationMessageFor(model => model.StreetSuffix)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.StreetPostDir)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.StreetPostDir)
           @Html.ValidationMessageFor(model => model.StreetPostDir)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.StreetPreQual)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.StreetPreQual)
           @Html.ValidationMessageFor(model => model.StreetPreQual)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.StreetPostQual)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.StreetPostQual)
           @Html.ValidationMessageFor(model => model.StreetPostQual)
       </div>
       <div class="editor-label">
           @Html.LabelFor(model => model.Apartment)
       </div>
       <div class="editor-field">
           @Html.EditorFor(model => model.Apartment)
           @Html.ValidationMessageFor(model => model.Apartment)
       </div>
       <p>
       <input type="submit" value="Submit"/>
       </p>
   </fieldset>

}

@section Scripts {
   @Scripts.Render("~/bundles/jqueryval")
}
using System;
using System.Collections.Specialized;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using FusionServiceHelper.Models;

// NOTE: Replace 'MyController' with the name of your controller.

// 
// GET: /MyController/PostReadLandByAddress
public ActionResult PostReadLandByAddress()
{
   // Create a new instance of the model to pick up any default values.
   PostReadLandByAddress model =  new PostReadLandByAddress();

   // pass model to set to default values
   // NOTE: Change 'MyFolderPath' to the path to the .cshtml file.
   return View("~/Views/MyFolderPath/PostReadLandByAddress.cshtml", model);
}

// 
// POST: /MyController/PostReadLandByAddress
[HttpPost]
public ActionResult PostReadLandByAddress(FormCollection collection)
{
   string url = "v2/NaviLine/Land/SearchByAddress";
   // Get the value from each input field
   NameValueCollection inputParms = new NameValueCollection();
   inputParms.Add("StreetNo", collection["StreetNo"]);
   inputParms.Add("StreetDir", collection["StreetDir"]);
   inputParms.Add("StreetName", collection["StreetName"]);
   inputParms.Add("StreetSuffix", collection["StreetSuffix"]);
   inputParms.Add("StreetPostDir", collection["StreetPostDir"]);
   inputParms.Add("StreetPreQual", collection["StreetPreQual"]);
   inputParms.Add("StreetPostQual", collection["StreetPostQual"]);
   inputParms.Add("Apartment", collection["Apartment"]);

   try
   {
       // Send the request
       FusionServiceRequest request = new FusionServiceRequest();
       FusionServiceResult result = request.Post(url, inputParms);

       return View("Result", result);
   }
   catch(Exception e)
   {
       HandleErrorInfo info = new HandleErrorInfo(e, "MyController", "PostReadLandByAddress");
       return View("Error", info);
   }
}