Loqate Harmony Documentation
  • GBG Loqate AU & NZ
  • Loqate Harmony API
    • Sign up for free trial
    • Login
    • API Specification
      • Authentication
      • Address
        • Address Validation & Lookup
        • Address by Geocode
        • Address Cleanse
        • Address Parse
        • Geocode Intl
      • Address Insights
        • Australian Insights
          • SEIFA Australia
          • ASGS Australia Statistical Geography Standard
          • Residential / Commercial
          • Deliverable address
      • Suburb Lookup
      • Business Validation and Lookup
      • Email Validation
      • Phone Validation
      • Matching
      • Moved Suppression
      • Deceased Suppression
      • Objects
        • Address Objects
        • Address Type Objects
        • Suburb Objects
        • Parse Objects
        • Email Objects
        • Phone Objects
        • Property Title Objects
        • Match Objects
        • Business Objects
      • Deprecated API services
        • Email Validation v1.1
        • Address v1
        • Address Cleanse v1
        • Address International
        • Address Combined
        • Address Types
    • Guides
      • Best Practices
        • Address Field Mappings
        • Finding an Address
      • User Derived Address
      • Expanded sub-premise reach
      • Parcel Locker Plus
      • Migrating to Address V2
      • Sign up/ Login
      • Support
      • Console
        • Getting your API keys
        • Getting Started
        • Add a Service
        • Dashboard
        • Subscriptions
          • Features
          • Users
          • Subscribed Plans
          • Allowlisting domains
          • Blocklist - Email Validation
        • Reports
        • Invoices
          • Paying Invoices
      • API Latency
    • Demos
      • How to use our demos
      • Address Validation Demo
      • Address by Geocode (Reverse Geocode) Demo
      • Address Cleanse Demo
      • Address Parse Demo
      • Business Validation Demo
      • Email Validation Demo
      • Phone Validation demo
    • Integrations
      • Client Libraries
        • Javascript Library v2.1.0
      • Adobe Commerce (Magento 2) Plugin
        • Magento2 User Guide
      • Woocommerce Plugin
        • Woocommerce Install Guide v2.0.0
        • Woocommerce Settings guide v2.0.0
      • Shopify Plus App
      • Gravity Forms
      • Voxco Survey Software
      • Salesforce CRM
      • Dynamics 365 CRM
      • Batch App - Lightweight
      • Deprecated Integrations
        • Harmony RightAddress c# example
        • Harmony RightAddress cURL example
        • Deprecated JS Library v2.0.1
        • Deprecated JQuery Library v1.8.1
    • Coverage
    • Address Exchange (Beta)
      • ADX Console
        • Searching Addresses in console
        • Create Address in console
        • Create Actions in console
      • ADX API Specification
        • Create Address
        • Get Address
        • Create Address Event
        • Edit Address Event
        • Create/Edit Address Attributes
        • Create/Edit Address Geopoint
        • Get Source Events
      • Reserved Attributes
    • GBG Status
  • Batch / Bulk Data Services
    • Serviced Batch
      • Bulk Address Cleanse
      • Email Serviced Batch
      • Phone Serviced Batch
      • Business Serviced Batch
  • Harmony Suite
    • Harmony Suite Overview
    • Release Notes
      • Version 3.0.0
        • New Features
        • Enhancements
        • Bug Fixes
        • Supported Platforms
    • User Guides
      • Version 3.0.0
        • Welcome to Harmony Suite
        • Glossary of terms
        • Upgrades
          • HSQL Upgrade
        • Email and Phone Validation
          • Prerequisites
          • Phone and Email PDP Configuration Setup
          • Phone Validation using Harmony Batch System
          • Phone Validation using Harmony WS
          • Email Validation using Harmony Batch
          • Email Validation using Harmony WS
          • Guides
            • Understanding Phone Data
            • Understanding Email Data
        • Business Lookup and Validation
          • Prerequisites
          • Business Lookup
          • Business Validation
            • Business Validation using Commercial Name Parser
            • Business Validation Configurations
            • Business Validation using Harmony Batch System
            • Business Validation using Harmony WS
          • Business data update guide
          • Guides
            • Understanding Business Data
            • Understanding Business Verification Code
            • Name Parse Ambiguity
        • Australia Post Parcel Locker Plus Lookup and Validation
          • Prerequisites
          • Australia Post Parcel Locker Plus Lookup
          • Australia Post Parcel Locker Plus Validation
            • PDP Configuration Setup
            • AupostValidation using Harmony Batch System
            • AupostValidation using Harmony WS
          • Guides
            • Knowledgebase Lexical Update
            • Understanding Australia Post Parcel Locker Plus Data
            • Interchangeable terms for Australia Post Parcel Lockers
        • Installation and Upgrade Reference Guide
        • Locate Reference Guide
        • Extensions Reference Guide
        • RealTime Reference Guide
        • Postmaster Reference Guide
        • Rapid Address ANZ Reference Guide
        • Post ANZ Reference Guide
        • Source of Truth Installation Reference Guide
        • Knowledgebase Configuration Reference Guide
        • Web Services Reference Guide
        • Management Console Reference Guide
        • Batch System Match Reference Guide
        • Batch System Cleanse Reference Guide
  • More from GBG
    • GBG GreenID
    • GBG Identity
    • GBG Fraud & Compliance
Powered by GitBook
On this page
  • Address Find
  • Quick Tips
  • Understanding an Address
  • Use Wildcards '*'
  • Method: Numbers First
  • Method: Letters Premise then sub-dwellings
  1. Loqate Harmony API
  2. Guides
  3. Best Practices

Finding an Address

This guide details the best methods for finding an Address using GBG Loqate Australia & New Zealand services

PreviousAddress Field MappingsNextUser Derived Address

Last updated 2 years ago

Address Find

Related Service

Quick Tips

All tips are generalisations on how to get the best performance overtime. Every country has a different way to input an address, which means end users enter addresses in many different ways and structures.

These tips are designed to be consistently fast and accurate, they may not be the outright fastest but they consistently work.

Always helps:

  • Key fields: StreetNumber, StreetName, Postcode - '20 HIGH 2334’

  • Any Order with numbers first, starting with postcode '2334 20 HIGH' yields similar results as '20 example 2121’. Why? Typing numbers is faster. For phone operators easier to understand and limits incorrect spelling.

  • Find 'premise' first then extend to a sub-dwelling.

  • Wildcards '': unsure about something use a wildcard. - ' 20 HI 2334 ' or ' UNIT 21 44 BRI* 2000'

What can impede:

  • Unit & unit numbers. Units will appear as options if you search Street method. Specifing Unit does narrow the search, however, being too narrow can be disadvantage if the Unit is not within the data for example commercial sublets may not have Unit sub-dwelling.

  • Trying to spell Suburbs you don't know 'sombre' when 'sunbury'. Misspellings are common offers limited optimisation. Use postcode instead.

Adds time with little benefit:

  • Typing the Street types e.g. 'Street, Road, Close'.

  • Typing Suburbs - Simply a postcode is more useful. It is highly unusual to 2 identical addresses expect suburb within a postcode.

Understanding an Address

Addresses comprise many components and interpretations around the world. Below diagram helps give a visual representation of an address.

Use Wildcards '*'

A wildcard replaces 'known' input with 'unknown' input. Entering a wildcard is the star (in blue) '*'

  • Wildcards can be used on any component of an address.

  • You can use multiple wildcards in a search - one per component.

  • Wildcards can be used in the start, end or middle of a component. '*AL' or 'MAL*' or 'M*LEE'

Method: Numbers First

Target Address: ‘4 MALLEE COURT, SUNBURY VIC 3429’

Method: {postcode} {streetNumber} {streetName}.

Numbers are easier to hear and faster to type.

Input examples:

  • '3429 4 MALLEE’

  • '3429 4 MAL* SUN*' Unsure of multiple spellings – use wildcard

  • '34* 4 MALLEE' - missed a number? - use wildcard

  • '3429 4 M*LEE' - unsure of street spelling – use wildcard

Method: Letters Premise then sub-dwellings

Target Address: ‘UNIT 5 25 NEPEAN HIGHWAY, ASPENDALE VIC 3195’

Method: {streetNumber} {streetName} {postcode} {subdwelling}.

We don't recommend adding subdwelling component until after premise component. Its more efficient to find the premise then extend to the subdwelling.

NB: Not all sub-dwellings are in our trusted data sources. This is industry wide problem.

Input examples:

  • '25 NEPEAN 3195’ - gives all matching 25 Nepean. Sometimes Units will not be in the data and only premise match is possible.

  • '25 NEPEAN 3195 5' - Extend with UnitNumber. All subdwelling types (unit, flat) with 5.

  • '25 NEPEAN 3195 Unit' - Extend with Unit all matching units within 25 Nepean

  • '* NEPEAN 3195 Unit 5' - all matching 'unit 5' on Nepean StreetName

  • '25 NEP* 3195 Unit' - unsure of street spelling – use wildcard

Address Validation & Lookup