Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Generates suggestions for addresses and points of interest based on partial or misspelled free-form text. This operation is also known as autocomplete, autosuggest, or fuzzy matching.
Optional parameters let you narrow your search results by bounding box or country, or bias your search toward a specific position on the globe.
You can search for suggested place names near a specified position by
using BiasPosition
, or filter results within a bounding box by using
FilterBBox
. These parameters are mutually exclusive; using both
BiasPosition
and FilterBBox
in the same command returns an error.
Synopsis
- data SearchPlaceIndexForSuggestions = SearchPlaceIndexForSuggestions' {}
- newSearchPlaceIndexForSuggestions :: Text -> Text -> SearchPlaceIndexForSuggestions
- searchPlaceIndexForSuggestions_biasPosition :: Lens' SearchPlaceIndexForSuggestions (Maybe (NonEmpty Double))
- searchPlaceIndexForSuggestions_filterBBox :: Lens' SearchPlaceIndexForSuggestions (Maybe (NonEmpty Double))
- searchPlaceIndexForSuggestions_filterCountries :: Lens' SearchPlaceIndexForSuggestions (Maybe (NonEmpty Text))
- searchPlaceIndexForSuggestions_language :: Lens' SearchPlaceIndexForSuggestions (Maybe Text)
- searchPlaceIndexForSuggestions_maxResults :: Lens' SearchPlaceIndexForSuggestions (Maybe Natural)
- searchPlaceIndexForSuggestions_indexName :: Lens' SearchPlaceIndexForSuggestions Text
- searchPlaceIndexForSuggestions_text :: Lens' SearchPlaceIndexForSuggestions Text
- data SearchPlaceIndexForSuggestionsResponse = SearchPlaceIndexForSuggestionsResponse' {}
- newSearchPlaceIndexForSuggestionsResponse :: Int -> SearchPlaceIndexForSuggestionsSummary -> SearchPlaceIndexForSuggestionsResponse
- searchPlaceIndexForSuggestionsResponse_httpStatus :: Lens' SearchPlaceIndexForSuggestionsResponse Int
- searchPlaceIndexForSuggestionsResponse_results :: Lens' SearchPlaceIndexForSuggestionsResponse [SearchForSuggestionsResult]
- searchPlaceIndexForSuggestionsResponse_summary :: Lens' SearchPlaceIndexForSuggestionsResponse SearchPlaceIndexForSuggestionsSummary
Creating a Request
data SearchPlaceIndexForSuggestions Source #
See: newSearchPlaceIndexForSuggestions
smart constructor.
SearchPlaceIndexForSuggestions' | |
|
Instances
newSearchPlaceIndexForSuggestions Source #
Create a value of SearchPlaceIndexForSuggestions
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
SearchPlaceIndexForSuggestions
, searchPlaceIndexForSuggestions_biasPosition
- An optional parameter that indicates a preference for place suggestions
that are closer to a specified position.
If provided, this parameter must contain a pair of numbers. The first number represents the X coordinate, or longitude; the second number represents the Y coordinate, or latitude.
For example, [-123.1174, 49.2847]
represents the position with
longitude -123.1174
and latitude 49.2847
.
BiasPosition
and FilterBBox
are mutually exclusive. Specifying both
options results in an error.
SearchPlaceIndexForSuggestions
, searchPlaceIndexForSuggestions_filterBBox
- An optional parameter that limits the search results by returning only
suggestions within a specified bounding box.
If provided, this parameter must contain a total of four consecutive numbers in two pairs. The first pair of numbers represents the X and Y coordinates (longitude and latitude, respectively) of the southwest corner of the bounding box; the second pair of numbers represents the X and Y coordinates (longitude and latitude, respectively) of the northeast corner of the bounding box.
For example, [-12.7935, -37.4835, -12.0684, -36.9542]
represents a
bounding box where the southwest corner has longitude -12.7935
and
latitude -37.4835
, and the northeast corner has longitude -12.0684
and latitude -36.9542
.
FilterBBox
and BiasPosition
are mutually exclusive. Specifying both
options results in an error.
SearchPlaceIndexForSuggestions
, searchPlaceIndexForSuggestions_filterCountries
- An optional parameter that limits the search results by returning only
suggestions within the provided list of countries.
- Use the ISO 3166
3-digit country code. For example, Australia uses three upper-case
characters:
AUS
.
SearchPlaceIndexForSuggestions
, searchPlaceIndexForSuggestions_language
- The preferred language used to return results. The value must be a valid
BCP 47 language tag, for example,
en
for English.
This setting affects the languages used in the results. If no language is specified, or not supported for a particular result, the partner automatically chooses a language for the result.
For an example, we'll use the Greek language. You search for
Athens, Gr
to get suggestions with the language
parameter set to
en
. The results found will most likely be returned as
Athens, Greece
.
If you set the language
parameter to el
, for Greek, then the result
found will more likely be returned as Αθήνα, Ελλάδα
.
If the data provider does not have a value for Greek, the result will be in a language that the provider does support.
SearchPlaceIndexForSuggestions
, searchPlaceIndexForSuggestions_maxResults
- An optional parameter. The maximum number of results returned per
request.
The default: 5
SearchPlaceIndexForSuggestions
, searchPlaceIndexForSuggestions_indexName
- The name of the place index resource you want to use for the search.
SearchPlaceIndexForSuggestions
, searchPlaceIndexForSuggestions_text
- The free-form partial text to use to generate place suggestions. For
example, eiffel tow
.
Request Lenses
searchPlaceIndexForSuggestions_biasPosition :: Lens' SearchPlaceIndexForSuggestions (Maybe (NonEmpty Double)) Source #
An optional parameter that indicates a preference for place suggestions that are closer to a specified position.
If provided, this parameter must contain a pair of numbers. The first number represents the X coordinate, or longitude; the second number represents the Y coordinate, or latitude.
For example, [-123.1174, 49.2847]
represents the position with
longitude -123.1174
and latitude 49.2847
.
BiasPosition
and FilterBBox
are mutually exclusive. Specifying both
options results in an error.
searchPlaceIndexForSuggestions_filterBBox :: Lens' SearchPlaceIndexForSuggestions (Maybe (NonEmpty Double)) Source #
An optional parameter that limits the search results by returning only suggestions within a specified bounding box.
If provided, this parameter must contain a total of four consecutive numbers in two pairs. The first pair of numbers represents the X and Y coordinates (longitude and latitude, respectively) of the southwest corner of the bounding box; the second pair of numbers represents the X and Y coordinates (longitude and latitude, respectively) of the northeast corner of the bounding box.
For example, [-12.7935, -37.4835, -12.0684, -36.9542]
represents a
bounding box where the southwest corner has longitude -12.7935
and
latitude -37.4835
, and the northeast corner has longitude -12.0684
and latitude -36.9542
.
FilterBBox
and BiasPosition
are mutually exclusive. Specifying both
options results in an error.
searchPlaceIndexForSuggestions_filterCountries :: Lens' SearchPlaceIndexForSuggestions (Maybe (NonEmpty Text)) Source #
An optional parameter that limits the search results by returning only suggestions within the provided list of countries.
- Use the ISO 3166
3-digit country code. For example, Australia uses three upper-case
characters:
AUS
.
searchPlaceIndexForSuggestions_language :: Lens' SearchPlaceIndexForSuggestions (Maybe Text) Source #
The preferred language used to return results. The value must be a valid
BCP 47 language tag, for example,
en
for English.
This setting affects the languages used in the results. If no language is specified, or not supported for a particular result, the partner automatically chooses a language for the result.
For an example, we'll use the Greek language. You search for
Athens, Gr
to get suggestions with the language
parameter set to
en
. The results found will most likely be returned as
Athens, Greece
.
If you set the language
parameter to el
, for Greek, then the result
found will more likely be returned as Αθήνα, Ελλάδα
.
If the data provider does not have a value for Greek, the result will be in a language that the provider does support.
searchPlaceIndexForSuggestions_maxResults :: Lens' SearchPlaceIndexForSuggestions (Maybe Natural) Source #
An optional parameter. The maximum number of results returned per request.
The default: 5
searchPlaceIndexForSuggestions_indexName :: Lens' SearchPlaceIndexForSuggestions Text Source #
The name of the place index resource you want to use for the search.
searchPlaceIndexForSuggestions_text :: Lens' SearchPlaceIndexForSuggestions Text Source #
The free-form partial text to use to generate place suggestions. For
example, eiffel tow
.
Destructuring the Response
data SearchPlaceIndexForSuggestionsResponse Source #
See: newSearchPlaceIndexForSuggestionsResponse
smart constructor.
SearchPlaceIndexForSuggestionsResponse' | |
|
Instances
newSearchPlaceIndexForSuggestionsResponse Source #
Create a value of SearchPlaceIndexForSuggestionsResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:httpStatus:SearchPlaceIndexForSuggestionsResponse'
, searchPlaceIndexForSuggestionsResponse_httpStatus
- The response's http status code.
$sel:results:SearchPlaceIndexForSuggestionsResponse'
, searchPlaceIndexForSuggestionsResponse_results
- A list of place suggestions that best match the search text.
$sel:summary:SearchPlaceIndexForSuggestionsResponse'
, searchPlaceIndexForSuggestionsResponse_summary
- Contains a summary of the request. Echoes the input values for
BiasPosition
, FilterBBox
, FilterCountries
, Language
,
MaxResults
, and Text
. Also includes the DataSource
of the place
index.
Response Lenses
searchPlaceIndexForSuggestionsResponse_httpStatus :: Lens' SearchPlaceIndexForSuggestionsResponse Int Source #
The response's http status code.
searchPlaceIndexForSuggestionsResponse_results :: Lens' SearchPlaceIndexForSuggestionsResponse [SearchForSuggestionsResult] Source #
A list of place suggestions that best match the search text.
searchPlaceIndexForSuggestionsResponse_summary :: Lens' SearchPlaceIndexForSuggestionsResponse SearchPlaceIndexForSuggestionsSummary Source #
Contains a summary of the request. Echoes the input values for
BiasPosition
, FilterBBox
, FilterCountries
, Language
,
MaxResults
, and Text
. Also includes the DataSource
of the place
index.