Address Autofill
This page includes reference documentation for the Address Autofill feature in the Mapbox Search JS Core framework.
Class
AddressAutofillCore
A AddressAutofillCore
object is an application's main entrypoint to the
Mapbox Address Autofill API. The Mapbox Address Autofill API is an API similar to SearchBoxCore,
but targeted towards address autocomplete.
Only address types are returned by the API.
AddressAutofillCore
is focused on the two-step, interactive search experience. These steps are:
- AddressAutofillCore#suggest: The user enters a search term, and a list of suggested results is returned with address data.
- AddressAutofillCore#retrieve: The user selects a result from the list of suggested results, and the corresponding geographic coordinates are returned.
A Mapbox access token is required to use AddressAutofillCore
, and
other options may be specified either in the constructor or in the AddressAutofillCore#suggest call.
Parameters
Instance Members
Methods
Options and Type Definitions
AddressAutofillOptions
Options used by AddressAutofillCore and useAddressAutofillCore to control the location, language, country, and limit of results. All properties are optional.
ObjectProperties
((string | LngLatBoundsLike))
: Limit results to only those contained within the supplied bounding box.
(string)
: An
ISO 3166 alpha-2 country code
to be returned. If not specified, results will not be filtered by country.
((string | LngLatLike))
: Bias the response to favor results that are closer to this location. Provide a point coordinate provided as a
LngLatLike
, or use the string
ip
to use the requester's IP address.
AddressAutofillSuggestion
An AddressAutofillSuggestion
object represents a suggestion
result from the Mapbox Address Autofill API.
Suggestion objects are "part one" of the two-step interactive autofill experience. Suggestion objects do not include geographic coordinates.
To get the coordinates of the result, use AddressAutofillCore#retrieve.
For tracking purposes, it is useful for any follow-up requests based on this suggestion to include same SessionToken as the original request.
ObjectProperties
(string)
: A point accuracy metric for the returned address feature. Can be one of
rooftop
,
parcel
,
point
,
interpolated
,
intersection
,
street
.
(string)
: The short form country name, for example: "us". This follows the
ISO 3166 alpha-2 country code
specification.
(MatchCode)
: An object describing the level of confidence that the given response feature matches the address intended by the request query.
Includes boolean flags denoting matches for each address sub-component.
({iso_3166_1: string})
: Address metadata fields of the feature.
Includes the short form country name, for example: "us". This follows the ISO 3166 alpha-2 country code specification.
(string)
: A string representing the feature in the requested language, if specified, and its full result hierarchy.
(Array<string>)
: An array of strings representing the geographic feature type of the feature.
Possible values include "address" and "secondary_address".
Example
const autofill = new AddressAutofillCore({ accessToken: 'pk.my-mapbox-access-token' });
const sessionToken = new SessionToken();
const result = await search.autofill('Washington D.C.', { sessionToken });
if (result.suggestions.length === 0) return;
const suggestion = result.suggestions[0];
const { features } = await autofill.retrieve(suggestion, { sessionToken });
doSomethingWithCoordinates(features);
AddressAutofillFeatureSuggestion
An AddressAutofillFeatureSuggestion
object represents GeoJSON
suggestion results from the Mapbox Address Autofill API.
As per the Mapbox Address Autofill API, this will always be Point.
anyExample
const featureSuggestion = {
type: 'Feature',
geometry: {
type: 'Point',
coordinates: [0,0]
},
properties: {
feature_name: 'Washington D.C.',
}
};
Static Members
MatchCode
An object describing the level of confidence that the given response feature matches the address intended by the request query.
ObjectProperties
(MatchCodeType)
: An indication of how well the
address_number
component of the feature matches the query.
(MatchCodeConfidence)
: An overall confidence level for how well the feature matches the query.
(MatchCodeType)
: An indication of how well the
country
component of the feature matches the query.
(MatchCodeType)
: An indication of how well the
locality
component of the feature matches the query.
(MatchCodeType)
: An indication of how well the
place
component of the feature matches the query.
(MatchCodeType)
: An indication of how well the
postcode
component of the feature matches the query.
(MatchCodeType)
: An indication of how well the
region
component of the feature matches the query.
(MatchCodeType)
: An indication of how well the
secondary_address
component of the feature matches the query.
(MatchCodeType)
: An indication of how well the
street
component of the feature matches the query.
MatchCodeType
An indication of how well a context component of the feature matches the query.
Static Members
MatchCodeConfidence
An overall confidence level for how well the feature matches the query.