What Is Context?
When you perform a search for an address element, BuildGlobalAddress looks at the address elements that you have already committed and splits up the values it returns based on whether or not the returned values exist within the context of the address elements you have already committed. For example, in the U.S. the following cities exist:
In Illinois:
- CHICAGO
- CHICAGO HTS
- CHICAGO RIDGE
- NORTH CHICAGO
- WEST CHICAGO
In Indiana:
- EAST CHICAGO
In Nevada:
- CHICAGO PARK
If you have already committed a value of "IN" (Indiana) for the state and then searched for the city "chicago", BuildGlobalAddress would return EAST CHICAGO as an "in context" result because it exists in Indiana, and it would return all the other matches for "chicago" as out-of-context results. Likewise, if you committed a value of "IL" (Illinois) for the state, BuildGlobalAddress would return EAST CHICAGO and CHICAGO PARK as out of context, and CHICAGO, CHICAGO HTS, CHICAGO RIDGE, NORTH CHICAGO, and WEST CHICAGO as "in context."