User Guide: APO (Address/Parcel/Owner) Field & Property Selection

Last updated: January 15, 2026

---

Overview

The APO (Address/Parcel/Owner) Field provides a unified way to select properties in permit applications. Instead of manually entering address details, you can search the jurisdiction's property database and select the correct property with verified information.

Benefits

• Accuracy - Property data comes directly from county GIS records
• Completeness - Address, parcel, and owner information linked automatically
• Speed - Search by any identifier (address, parcel number, owner name)
• Validation - Ensures permits are tied to valid county properties

---

For Citizens: Using the APO Field

Understanding the Property Selection Interface

When you encounter an APO field in a permit application, you'll see three connected dropdown fields:

1. Address - The property street address
2. Parcel - The parcel/lot identifier (APN)
3. Owner - The property owner name

These fields work together - selecting one filters the options for the others.

Step-by-Step: Selecting Your Property

Option 1: Search by Address

1. Click the Address dropdown field
2. Start typing the street address (e.g., "123 Main")
3. As you type, matching addresses appear in the dropdown
4. Select your property address from the list
5. Parcel and Owner fields automatically update with related records

Option 2: Search by Parcel Number

1. Click the Parcel dropdown field
2. Enter the parcel number or APN (Assessor's Parcel Number)
3. Select the matching parcel from results
4. Address and Owner fields filter to show related records

Option 3: Search by Owner Name

1. Click the Owner dropdown field
2. Type the property owner's name
3. Select from matching owner records
4. Address and Parcel fields filter to show related properties

Cascading Selection Logic

The APO fields use intelligent filtering:

Example:

1. You search for "123 Main Street" in Address
2. Parcel field now shows only parcels at 123 Main Street
3. Owner field shows only owners of parcels at 123 Main Street
4. If 123 Main Street has one parcel with one owner, all three fields populate automatically

Confirming Your Selection

After selecting your property:

1. Review the summary display showing:
   • Address: Full street address
   • Parcel: APN and lot number
   • Owner: Property owner full name
2. Verify the information is correct
3. Continue with your application

Handling Partial Records

Sometimes property records may be incomplete:

Missing Address:

• Property exists but no address on file
• You'll see the parcel and owner, but address shows "—"
• Contact staff if you believe this is an error

Missing Parcel:

• Address exists but not linked to a parcel
• May occur for new subdivisions or data updates in progress

Missing Owner:

• Parcel exists but ownership data not yet recorded
• Common for recently transferred properties

---

Understanding APO Field Display

Edit Mode (When Filling Out Forms)

In edit mode, you see three interactive dropdown fields:

View Mode (After Submission)

Once your application is submitted, the APO field displays as read-only:

Required Field Configuration

Depending on the permit type, different APO components may be required:

The form will indicate required fields with an asterisk (*).

---

Special Scenarios

Multiple Owners on One Parcel

If a property has multiple owners:

1. All owners appear in the Owner dropdown
2. Select the primary contact/applicant
3. Additional owners can be added in contact sections

Multiple Parcels at One Address

For properties spanning multiple parcels:

1. The Address dropdown shows the shared address
2. The Parcel dropdown lists all parcels at that address
3. Select the specific parcel for this permit
4. Create separate permits for different parcels if needed

New Construction / No Existing Address

For new construction without an assigned address:

1. Search by the parcel number instead
2. Or search by the current owner name
3. The address may show as "—" or "Unassigned"
4. County staff will update the address when assigned

---

For Inspection Scheduling

When scheduling inspections, the APO field provides additional benefits:

Tax Map Identification

After selecting your property:

• The system identifies which Tax Map Zone your property is in
• This determines which inspectors cover your area
• You'll see a message like:

  "Your property is in Tax Map 2 - Central Howard County"

Location Not in Tax Map

If you see:

"This location does not match any tax maps"

This means:

• The property may be outside county jurisdiction
• The GIS data may need updating
• Contact county staff for assistance

---

Troubleshooting

Common Issues

Q: My address doesn't appear in the search results. A: Try these approaches:

1. Search by parcel number instead
2. Use partial address (just street number and name)
3. Check for different address formats (St. vs Street)
4. Contact staff if your property is newly built or subdivided

Q: The owner name shown is incorrect. A: Property ownership records come from county tax records. If ownership recently changed:

1. Continue with the permit using current records
2. Contact county staff to note the discrepancy
3. Provide ownership documentation if requested

Q: I selected an address but the wrong parcel appeared. A:

1. Clear your selection and try searching by parcel number directly
2. Some addresses span multiple parcels - verify the correct parcel
3. Contact staff if parcel data appears incorrect

Q: The field shows "—" for some values. A: This indicates missing data in county records. The permit can still be submitted, but:

1. Note which information is missing
2. Staff may contact you for clarification
3. Provide documentation of property details if available

Q: I can't find my property at all. A: Your property may be:

1. Outside your jurisdiction's boundaries
2. A new subdivision not yet in the system
3. Listed under a different address format
4. Contact Permitting Support for assistance

For Staff

Q: How do I add a property that's not in the APO database? A: Contact GIS administration to add new property records. APO data syncs from the jurisdiction's authoritative property database.

Q: Can I override APO selection for special cases? A: Some permit types allow manual address entry. Check entity configuration or consult system administration.

---

Related Features

• Citizen Portal Permit Lifecycle - Full application process
• Zone Management & Inspector Coverage - How tax maps affect inspections
• Inspector Scheduling - Booking inspections for your property

---

Technical Notes

Component Location: /apps/entity-manager-app/src/components/APOField/

Key Components:

• APOField.tsx - Interactive edit mode with cascading selection
• APOFieldViewMode.tsx - Read-only display mode
• AddressCombobox, ParcelCombobox, OwnerCombobox - Individual search fields

Backend Integration:

• GIS search service aggregates property data
• Supports search by address, parcel, owner, or APN
• Returns grouped results showing relationships

Data Structure:

• address.full_address - Complete street address
• parcel.apn - Assessor's Parcel Number
• parcel.lot - Lot identifier
• owner.full_name - Property owner name

---

For additional assistance, contact your System Administrator.