BullhornHub Geo Utils icon

BullhornHub Geo Utils

Address utilities: validate, normalize, format, convert, compare addresses

Actions10

Address Convert → Parse Location

AI-generated

Summary

Parse a free-form location string into structured address components, optionally auto-detecting or manually specifying which parts to extract, using a default country context for ambiguous cases.

Inputs

  • Authentication (required) — Choose between User Credentials (Email & Password) or Enterprise Credentials (API Key) for authentication.
  • Location String (required) — Provide the free-form location string to parse, such as "San Francisco, CA".
  • Default Country — Specify the default country for validation and normalization when no country is detectable in the location string.
  • Country Code — Provide a custom ISO 3166-1 alpha-2 country code if Default Country is set to 'Other'.
  • Parse Mode (required) — Choose between auto-detecting all parts of the location string or specifying manually which components (street address, city, state, zip, country) it contains.
  • Contains Street Address — Indicate if the location string contains a street address (used only if parse mode is manual).
  • Contains City — Indicate if the location string contains a city name (used only if parse mode is manual).
  • Contains State / Region — Indicate if the location string contains a state or region (used only if parse mode is manual).
  • Contains ZIP / Postal Code — Indicate if the location string contains a postal code (used only if parse mode is manual).
  • Contains Country — Indicate if the location string contains a country name or code (used only if parse mode is manual).

Output shape

a structured address object including recognized components such as street address, city, state/region, postal code, and country code

If 'auto' parse mode is selected, the node attempts to recognize and assign all parts automatically. In 'manual' mode, extraction is limited to parts explicitly enabled. The output includes validation and normalization based on the specified or default country context.

Examples

Example 1: Parsing a standard US location string with auto-detection

Authentication: Enterprise Credentials; Location String: "123 Main St, San Francisco, CA 94105"; Default Country: US; Parse Mode: Auto-Detect; Contains Fields: all defaults (street address, city, state, zip, country) enabled;

Links

Discussion