PlacesClient class
Las siete operaciones de Amazon Location Places v2.
| Método | Endpoint | Para qué |
|---|---|---|
| autocomplete | POST /v2/autocomplete |
escribir una dirección |
| searchText | POST /v2/search-text |
buscar un lugar por nombre |
| reverseGeocode | POST /v2/reverse-geocode |
de coordenada a dirección |
| getPlace | GET /v2/place/{id} |
la ficha completa |
| geocode | POST /v2/geocode |
de dirección a coordenada, con precisión |
| searchNearby | POST /v2/search-nearby |
qué hay cerca de un punto |
| suggest | POST /v2/suggest |
sugerencia más barata que autocomplete |
No se instancia a mano: se obtiene de CompassMaps.places.
Todas cuestan dinero
Cada llamada es una petición facturada. Las que se disparan al teclear —autocomplete y suggest— son las que más se descontrolan, y por eso llevan caché con caducidad: borrar una letra y volver a escribirla no paga dos veces.
El antirrebote, en cambio, no está aquí: depende del ritmo de escritura
y del hilo de la interfaz, y meterlo en el cliente obligaría a que el
núcleo supiera de temporizadores de interfaz. Va en el widget de búsqueda
de compass_maps_flutter.
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- intendedUse → IntendedUse
-
Si los resultados se van a guardar. Ver IntendedUse.
final
- language → String?
-
Idioma de los resultados, en BCP 47. Para Ecuador,
es.final - politicalView → String?
-
Punto de vista político para las fronteras en disputa, en ISO 3166.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
autocomplete(
{required String query, LatLng? biasPosition, SearchFilter? filter, int maxResults = 5, PostalCodeMode? postalCodeMode, List< PlaceFeature> additionalFeatures = const <PlaceFeature>[], String? language, bool useCache = true}) → Future<List< AutocompleteSuggestion> > -
Sugerencias mientras se escribe.
POST /v2/autocomplete. -
clearCache(
) → void - Vacía las cachés de este cliente.
-
geocode(
{String? queryText, AddressComponents? queryComponents, LatLng? biasPosition, List< String> includeCountries = const <String>[], int maxResults = 5, List<PlaceFeature> additionalFeatures = const <PlaceFeature>[], String? language, IntendedUse? intendedUse}) → Future<List< Place> > -
De dirección a coordenada, con puntuación de coincidencia.
POST /v2/geocode. -
getPlace(
String placeId, {List< PlaceFeature> additionalFeatures = const <PlaceFeature>[], String? language, IntendedUse? intendedUse, bool useCache = true}) → Future<Place> -
La ficha completa de un lugar.
GET /v2/place/{PlaceId}. -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
reverseGeocode(
LatLng position, {double? radiusMeters, int maxResults = 1, List< String> includePlaceTypes = const <String>[], List<PlaceFeature> additionalFeatures = const <PlaceFeature>[], String? language, IntendedUse? intendedUse}) → Future<List< Place> > -
De coordenada a dirección.
POST /v2/reverse-geocode. -
searchNearby(
{required LatLng position, double? radiusMeters, SearchFilter? filter, int maxResults = 10, List< PlaceFeature> additionalFeatures = const <PlaceFeature>[], String? nextToken, String? language, IntendedUse? intendedUse}) → Future<PlaceSearchResponse> -
Qué hay cerca de un punto.
POST /v2/search-nearby. -
searchText(
{String? queryText, String? queryId, LatLng? biasPosition, SearchFilter? filter, int maxResults = 10, List< PlaceFeature> additionalFeatures = const <PlaceFeature>[], String? nextToken, String? language, IntendedUse? intendedUse, bool useCache = true}) → Future<PlaceSearchResponse> -
Búsqueda por texto libre.
POST /v2/search-text. -
suggest(
{required String query, LatLng? biasPosition, SearchFilter? filter, int maxResults = 5, int? maxQueryRefinements, List< PlaceFeature> additionalFeatures = const <PlaceFeature>[], String? language}) → Future<SuggestResponse> -
Sugerencias mezcladas de sitios y de consultas.
POST /v2/suggest. -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited