El servicio de autocompletado del SDK de Places para Android muestra predicciones del lugar en respuesta a las búsquedas del usuario. A medida que el usuario escribe, el servicio de autocompletado muestra sugerencias para lugares como empresas, direcciones, códigos plus y lugares de interés.
Puedes agregar el autocompletado a tu aplicación de las siguientes formas:
- Agrega un widget de autocompletado para ahorrar tiempo de desarrollo y garantizar una experiencia del usuario coherente.
- Obtén predicciones de lugares de manera programática para crear una experiencia del usuario personalizada.
Cómo agregar un widget de autocompletado
El widget de autocompletado es un diálogo de búsqueda con la funcionalidad de autocompletado integrado. Cuando un usuario ingresa términos de búsqueda, el widget presenta una lista de lugares de predicción seleccionables. Cuando el usuario elige una opción, se muestra una instancia de Place, que tu app puede usar para obtener detalles sobre el lugar seleccionado.
Hay dos opciones para agregar el widget de autocompletado a tu aplicación:
- Opción 1: Incorpora un
AutocompleteSupportFragment. - Opción 2: Usa un intent para iniciar la actividad de autocompletado.
Opción 1: Incorporar un objeto AutocompleteSupportFragment
Para agregar una AutocompleteSupportFragment a tu app, sigue estos pasos:
- Agrega un fragmento al diseño XML de tu actividad.
- Agrega un objeto de escucha a tu actividad o fragmento.
Cómo agregar AutocompleteSupportFragment a una actividad
Para agregar AutocompleteSupportFragment a una actividad, agrega un fragmento nuevo a un diseño XML. Por ejemplo:
<fragment android:id="@+id/autocomplete_fragment"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:name="com.google.android.libraries.places.widget.AutocompleteSupportFragment"
/>
- De forma predeterminada, el fragmento no tiene límite ni fondo. Para proporcionar una apariencia visual coherente, anida el fragmento dentro de otro elemento de diseño, como una CardView.
- Si estás usando el fragmento de Autocomplete y necesitas anular
onActivityResult, debes llamar asuper.onActivityResult; de lo contrario, el fragmento no funcionará correctamente.
Cómo agregar un PlaceSelectionListener a una actividad
PlaceSelectionListener controla la visualización de un lugar en respuesta a la selección del usuario. En el siguiente código, se muestra cómo crear una referencia al fragmento y agregar un objeto de escucha en AutocompleteSupportFragment:
Java
// Initialize the AutocompleteSupportFragment.
AutocompleteSupportFragment autocompleteFragment = (AutocompleteSupportFragment)
getSupportFragmentManager().findFragmentById(R.id.autocomplete_fragment);
// Specify the types of place data to return.
autocompleteFragment.setPlaceFields(Arrays.asList(Place.Field.ID, Place.Field.NAME));
// Set up a PlaceSelectionListener to handle the response.
autocompleteFragment.setOnPlaceSelectedListener(new PlaceSelectionListener() {
@Override
public void onPlaceSelected(@NonNull Place place) {
// TODO: Get info about the selected place.
Log.i(TAG, "Place: " + place.getName() + ", " + place.getId());
}
@Override
public void onError(@NonNull Status status) {
// TODO: Handle the error.
Log.i(TAG, "An error occurred: " + status);
}
});
Kotlin
// Initialize the AutocompleteSupportFragment.
val autocompleteFragment =
supportFragmentManager.findFragmentById(R.id.autocomplete_fragment)
as AutocompleteSupportFragment
// Specify the types of place data to return.
autocompleteFragment.setPlaceFields(listOf(Place.Field.ID, Place.Field.NAME))
// Set up a PlaceSelectionListener to handle the response.
autocompleteFragment.setOnPlaceSelectedListener(object : PlaceSelectionListener {
override fun onPlaceSelected(place: Place) {
// TODO: Get info about the selected place.
Log.i(TAG, "Place: ${place.name}, ${place.id}")
}
override fun onError(status: Status) {
// TODO: Handle the error.
Log.i(TAG, "An error occurred: $status")
}
})
Opción 2: Usa un intent para iniciar la actividad de autocompletado
Si deseas que tu app use un flujo de navegación diferente (por ejemplo, activar la experiencia de autocompletado a partir de un ícono en lugar de un campo de búsqueda), tu app puede iniciar el autocompletado mediante un intent.
Para iniciar el widget de autocompletado por medio de una intent, sigue estos pasos:
- Usa
Autocomplete.IntentBuilderpara crear un intent y pasa el modoAutocompletedeseado. El intent debe llamar astartActivityForResulty pasar un código de solicitud que lo identifique. - Anula la devolución de llamada
onActivityResultpara recibir el lugar seleccionado.
Cómo crear un intent de autocompletado
En el siguiente ejemplo, se muestra cómo usar Autocomplete.IntentBuilder para crear un intent que inicie el widget de autocompletado como un intent:
Java
private static int AUTOCOMPLETE_REQUEST_CODE = 1;
// Set the fields to specify which types of place data to
// return after the user has made a selection.
List<Place.Field> fields = Arrays.asList(Place.Field.ID, Place.Field.NAME);
// Start the autocomplete intent.
Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
.build(this);
startActivityForResult(intent, AUTOCOMPLETE_REQUEST_CODE);
Kotlin
private val AUTOCOMPLETE_REQUEST_CODE = 1
// Set the fields to specify which types of place data to
// return after the user has made a selection.
val fields = listOf(Place.Field.ID, Place.Field.NAME)
// Start the autocomplete intent.
val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
.build(this)
startActivityForResult(intent, AUTOCOMPLETE_REQUEST_CODE)
Cuando uses un intent para iniciar el widget de autocompletado, puedes elegir entre los modos de visualización de superposición o de pantalla completa. En las siguientes capturas de pantalla, se muestra cada modo de visualización, respectivamente:
Anula la devolución de llamada onActivityResult
Para recibir una notificación cuando el usuario selecciona un lugar, tu app debe anular el onActivityResult() de la actividad y buscar el código de solicitud que pasaste para tu intent, como se muestra en el siguiente ejemplo.
Java
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
if (requestCode == AUTOCOMPLETE_REQUEST_CODE) {
if (resultCode == RESULT_OK) {
Place place = Autocomplete.getPlaceFromIntent(data);
Log.i(TAG, "Place: " + place.getName() + ", " + place.getId());
} else if (resultCode == AutocompleteActivity.RESULT_ERROR) {
// TODO: Handle the error.
Status status = Autocomplete.getStatusFromIntent(data);
Log.i(TAG, status.getStatusMessage());
} else if (resultCode == RESULT_CANCELED) {
// The user canceled the operation.
}
return;
}
super.onActivityResult(requestCode, resultCode, data);
}
Kotlin
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
if (requestCode == AUTOCOMPLETE_REQUEST_CODE) {
when (resultCode) {
Activity.RESULT_OK -> {
data?.let {
val place = Autocomplete.getPlaceFromIntent(data)
Log.i(TAG, "Place: ${place.name}, ${place.id}")
}
}
AutocompleteActivity.RESULT_ERROR -> {
// TODO: Handle the error.
data?.let {
val status = Autocomplete.getStatusFromIntent(data)
Log.i(TAG, status.statusMessage ?: "")
}
}
Activity.RESULT_CANCELED -> {
// The user canceled the operation.
}
}
return
}
super.onActivityResult(requestCode, resultCode, data)
}
Obtén predicciones de lugares de manera programática
Puedes crear una IU de búsqueda personalizada como alternativa a la IU que proporciona el widget de autocompletado. Para ello, tu app debe obtener predicciones de lugares de manera programática. Tu app puede obtener una lista de nombres de lugares o direcciones previstos desde la API de autocompletado llamando a PlacesClient.findAutocompletePredictions() y pasando un objeto FindAutocompletePredictionsRequest con los siguientes parámetros:
- Obligatorio: Una string
queryque contiene el texto que escribió el usuario. - Recomendado: Es una
AutocompleteSessionToken, que agrupa las fases de consulta y selección de una búsqueda del usuario en una sesión discreta con fines de facturación. La sesión comienza cuando el usuario comienza a escribir una consulta y finaliza cuando selecciona un lugar. - Recomendación: Es un objeto
RectangularBoundsque especifica los límites de latitud y longitud para restringir los resultados en la región especificada. - Opcional: Uno o más códigos de país de dos letras (ISO 3166-1 alfa-2), que indican el país o los países donde se deben restringir los resultados
Opcional: Un
TypeFilter, que puedes usar para restringir los resultados al tipo de lugar especificado Se admiten los siguientes tipos de lugares:TypeFilter.GEOCODE: muestra solo los resultados de la geocodificación, en lugar de las empresas. Usa esta solicitud para eliminar ambigüedades en los resultados en los que la ubicación especificada pueda ser indeterminada.TypeFilter.ADDRESS: muestra solo los resultados de autocompletado con una dirección precisa. Usa este tipo cuando sepas que el usuario buscará una dirección especificada con precisión.TypeFilter.ESTABLISHMENT: muestra solo los lugares que son negocios.TypeFilter.REGIONS: muestra solo los lugares que coinciden con uno de los siguientes tipos:LOCALITYSUBLOCALITYPOSTAL_CODECOUNTRYADMINISTRATIVE_AREA_LEVEL_1ADMINISTRATIVE_AREA_LEVEL_2
TypeFilter.CITIES: muestra solo los resultados que coinciden conLOCALITYoADMINISTRATIVE_AREA_LEVEL_3.
Opcional: Es un
LatLngque especifica la ubicación de origen de la solicitud. Cuando llamas asetOrigin(), el servicio muestra la distancia en metros (distanceMeters) desde el origen especificado, para cada predicción de autocompletado en la respuesta.
Para obtener información sobre los tipos de lugares, consulta la guía sobre tipos de lugares.
En el siguiente ejemplo, se muestra una llamada completa a PlacesClient.findAutocompletePredictions().
Java
// Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
// and once again when the user makes a selection (for example when calling fetchPlace()).
AutocompleteSessionToken token = AutocompleteSessionToken.newInstance();
// Create a RectangularBounds object.
RectangularBounds bounds = RectangularBounds.newInstance(
new LatLng(-33.880490, 151.184363),
new LatLng(-33.858754, 151.229596));
// Use the builder to create a FindAutocompletePredictionsRequest.
FindAutocompletePredictionsRequest request = FindAutocompletePredictionsRequest.builder()
// Call either setLocationBias() OR setLocationRestriction().
.setLocationBias(bounds)
//.setLocationRestriction(bounds)
.setOrigin(new LatLng(-33.8749937,151.2041382))
.setCountries("AU", "NZ")
.setTypesFilter(Arrays.asList(TypeFilter.ADDRESS.toString()))
.setSessionToken(token)
.setQuery(query)
.build();
placesClient.findAutocompletePredictions(request).addOnSuccessListener((response) -> {
for (AutocompletePrediction prediction : response.getAutocompletePredictions()) {
Log.i(TAG, prediction.getPlaceId());
Log.i(TAG, prediction.getPrimaryText(null).toString());
}
}).addOnFailureListener((exception) -> {
if (exception instanceof ApiException) {
ApiException apiException = (ApiException) exception;
Log.e(TAG, "Place not found: " + apiException.getStatusCode());
}
});
Kotlin
// Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
// and once again when the user makes a selection (for example when calling fetchPlace()).
val token = AutocompleteSessionToken.newInstance()
// Create a RectangularBounds object.
val bounds = RectangularBounds.newInstance(
LatLng(-33.880490, 151.184363),
LatLng(-33.858754, 151.229596)
)
// Use the builder to create a FindAutocompletePredictionsRequest.
val request =
FindAutocompletePredictionsRequest.builder()
// Call either setLocationBias() OR setLocationRestriction().
.setLocationBias(bounds)
//.setLocationRestriction(bounds)
.setOrigin(LatLng(-33.8749937, 151.2041382))
.setCountries("AU", "NZ")
.setTypesFilter(listOf(TypeFilter.ADDRESS.toString()))
.setSessionToken(token)
.setQuery(query)
.build()
placesClient.findAutocompletePredictions(request)
.addOnSuccessListener { response: FindAutocompletePredictionsResponse ->
for (prediction in response.autocompletePredictions) {
Log.i(TAG, prediction.placeId)
Log.i(TAG, prediction.getPrimaryText(null).toString())
}
}.addOnFailureListener { exception: Exception? ->
if (exception is ApiException) {
Log.e(TAG, "Place not found: " + exception.statusCode)
}
}
La API muestra un FindAutocompletePredictionsResponse en un
Task. El objeto FindAutocompletePredictionsResponse contiene una lista de objetos AutocompletePrediction que representan lugares predichos. La lista puede estar vacía si no hay un lugar conocido que corresponda a la consulta y a los criterios de filtro.
Para cada lugar de predicción, puedes llamar a los siguientes métodos a fin de recuperar detalles de un lugar:
getFullText(CharacterStyle)muestra el texto completo de una descripción del lugar. Esta es una combinación del texto principal y el secundario. Ejemplo: “Torre Eiffel, Avenue Anatole France, Paris, Francia”. Además, te permite destacar las secciones de la descripción que coincidan con la búsqueda con un estilo que elijas medianteCharacterStyle. El parámetroCharacterStylees opcional. Configúralo como nulo si no necesitas destacar nada.getPrimaryText(CharacterStyle)muestra el texto principal que describe un lugar. Este suele ser el nombre del lugar. Ejemplos: “Torre Eiffel” y “Calle Pitt 123”.getSecondaryText(CharacterStyle)muestra el texto secundario de una descripción del lugar. Esto es útil, por ejemplo, como segunda línea cuando se muestran las predicciones de autocompletado. Ejemplos: “Avenida Anatole France, París, Francia” y “Sídney, Nueva Gales del Sur”.getPlaceId()muestra el ID de lugar del lugar previsto. Un ID de lugar es un identificador textual que identifica de forma exclusiva un lugar y que puedes usar para recuperar el objetoPlacenuevamente. Si deseas obtener más información sobre los IDs de lugar en el SDK de Places para Android, consulta Place Details. Para obtener información general sobre los IDs de lugar, consulta la descripción general de los IDs de lugar.getPlaceTypes()muestra la lista de tipos de lugares asociados a este lugar.getDistanceMeters()muestra la distancia en línea recta en metros entre este lugar y el origen especificado en la solicitud.
Tokens de sesión
Los tokens de sesión agrupan las fases de consulta y selección de la búsqueda de autocompletado de un usuario en una sesión discreta con fines de facturación. La sesión comienza cuando el usuario comienza a escribir una consulta y finaliza cuando selecciona un lugar. Cada sesión puede tener varias consultas, seguidas de una selección de lugar. Una vez que finaliza una sesión, el token deja de ser válido. Tu app debe generar un token actualizado para cada sesión. Recomendamos usar tokens de sesión para todas las sesiones de autocompletado programático (cuando incorporas un fragmento o inicias la función de autocompletado con un intent, la API se encarga de esto automáticamente).
El SDK de Places para Android usa un objeto AutocompleteSessionToken para identificar cada sesión. Tu app debe pasar un nuevo token de sesión al comenzar cada nueva sesión y, luego, pasar ese mismo token, junto con un ID de lugar, en la llamada posterior a fetchPlace() para recuperar detalles de Place Details del lugar que seleccionó el usuario.
Obtén más información sobre los tokens de sesión.
Restringe los resultados de autocompletado
Puedes limitar los resultados de autocompletado a una región geográfica específica o filtrar los resultados según uno o más tipos de lugares o en hasta cinco países.
Puedes aplicar estas restricciones a la actividad de autocompletado, AutocompleteSupportFragment y a las API de autocompletado programático.
Para restringir los resultados, haz lo siguiente:
- Para preferir resultados dentro de la región definida, llama a
setLocationBias()(es posible que aun se muestren algunos resultados que no pertenecen a la región definida). - Para mostrar solo los resultados dentro de la región definida, llama a
setLocationRestriction()(solo se mostrarán los resultados dentro de la región definida). - Para mostrar solo los resultados que correspondan a un tipo de lugar en particular, llama a
setTypesFilter()(por ejemplo, si especificasTypeFilter.ADDRESS, solo se mostrarán resultados con una dirección precisa). - Si quieres que solo se muestren resultados de hasta cinco países específicos, llama a
setCountries(). Los países se deben pasar como un código de país compatible con la norma ISO 3166-1 Alpha-2 de dos caracteres.
Personaliza los resultados según una región específica
Para restringir los resultados de autocompletado a una región geográfica específica, llama a setLocationBias() y pasa una RectangularBounds.
En el siguiente ejemplo de código, se muestra cómo llamar a setLocationBias() en una instancia de fragmento para sesgar las sugerencias de autocompletado a una región de Sídney, Australia.
Java
autocompleteFragment.setLocationBias(RectangularBounds.newInstance(
new LatLng(-33.880490, 151.184363),
new LatLng(-33.858754, 151.229596)));
Kotlin
autocompleteFragment.setLocationBias(
RectangularBounds.newInstance(
LatLng(-33.880490, 151.184363),
LatLng(-33.858754, 151.229596)
)
)
Restringe los resultados a una región específica
Para restringir los resultados de autocompletado a una región geográfica específica, llama a setLocationRestriction() y pasa una RectangularBounds.
En el siguiente ejemplo de código, se muestra cómo llamar a setLocationRestriction() en una instancia de fragmento para restringir las sugerencias de autocompletado a una región de Sídney, Australia.
Java
autocompleteFragment.setLocationRestriction(RectangularBounds.newInstance(
new LatLng(-33.880490, 151.184363),
new LatLng(-33.858754, 151.229596)));
Kotlin
autocompleteFragment.setLocationRestriction(
RectangularBounds.newInstance(
LatLng(-33.880490, 151.184363),
LatLng(-33.858754, 151.229596)
)
)
Nota: Esta restricción solo se aplica a rutas completas. Los resultados sintéticos ubicados fuera de los límites rectangulares se pueden mostrar en función de una ruta que se superponga con la restricción de ubicación.
Filtrar resultados por tipo de lugar o colección de tipos
Puedes restringir los resultados de una solicitud de autocompletado para que solo muestren un determinado tipo de lugar. Especifica un filtro con los tipos de lugares o una colección de tipos enumerada en las tablas 1, 2 y 3 de los tipos de lugares. Si no se especifica nada, se muestran todos los tipos.
Para filtrar los resultados de autocompletado, llama a setTypesFilter() a fin de configurar el filtro.
Para especificar un tipo o un filtro de tipo de colección, haz lo siguiente:
Llama a
setTypesFilter()y especifica hasta cinco valores de type de la Tabla 1 y la Tabla 2 que se muestran en Tipos de lugares. Los valores de tipo se definen según las constantes de PlaceTypes.Llama a
setTypesFilter()y especifica una colección de tipos de la Tabla 3 que se muestra en Tipos de lugares. Los valores de colección se definen según las constantes de PlaceTypes.Solo se permite un tipo de la Tabla 3 en la solicitud. Si especificas un valor de la Tabla 3, no puedes especificar un valor de la Tabla 1 o la Tabla 2. Si lo haces, se produce un error.
En el siguiente ejemplo de código, se llama a setTypesFilter() en una AutocompleteSupportFragment y se especifican varios valores de tipo.
Java
autocompleteFragment.setTypesFilter(Arrays.asList("landmark", "restaurant", "store"));
Kotlin
autocompleteFragment.setTypesFilter(listOf("landmark", "restaurant", "store"))
En el siguiente ejemplo de código, se muestra cómo llamar a setTypesFilter() en AutocompleteSupportFragment para establecer un filtro que muestre solo resultados con una dirección precisa mediante la especificación de una colección de tipo.
Java
autocompleteFragment.setTypesFilter(Arrays.asList(TypeFilter.ADDRESS.toString()));
Kotlin
autocompleteFragment.setTypesFilter(listOf(TypeFilter.ADDRESS.toString()))
En el siguiente ejemplo de código, se muestra cómo llamar a setTypesFilter() en IntentBuilder para establecer un filtro que muestre solo resultados con una dirección precisa mediante la especificación de una colección de tipo.
Java
Intent intent = new Autocomplete.IntentBuilder(
AutocompleteActivityMode.FULLSCREEN, fields)
.setTypesFilter(Arrays.asList(TypeFilter.ADDRESS.toString()))
.build(this);
startActivityForResult(intent, AUTOCOMPLETE_REQUEST_CODE);
Kotlin
val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
.setTypesFilter(listOf(TypeFilter.ADDRESS.toString()))
.build(this)
startActivityForResult(intent, AUTOCOMPLETE_REQUEST_CODE)
Filtrar los resultados por país
Para filtrar los resultados de autocompletado de hasta cinco países, llama a setCountries() a fin de configurar el código de país.
Luego, pasa el filtro a un fragmento o una intent. Los países se deben pasar como un código de país ISO 3166-1 Alpha-2 de dos caracteres.
En el siguiente ejemplo de código, se muestra cómo llamar a setCountries() en un AutocompleteSupportFragment para configurar un filtro que muestre solo resultados dentro de los países especificados.
Java
autocompleteFragment.setCountries("AU", "NZ");
Kotlin
autocompleteFragment.setCountries("AU", "NZ")
Límites de uso
Tu uso de la API de Places, incluido el SDK de Places para Android, ya no se limita a una cantidad máxima de solicitudes por día (QPD). Sin embargo, se aplican los siguientes límites de uso:
- El límite de frecuencia es de 100 solicitudes por segundo (QPS). Se calcula como la suma de las solicitudes de cliente y servidor para todas las aplicaciones que usan las credenciales del mismo proyecto.
Mostrar atribuciones en tu aplicación
- Si tu app usa el servicio de autocompletado de manera programática, tu IU debe mostrar una atribución "Con la tecnología de Google" o aparecer dentro de un mapa de la marca Google.
- Si tu app usa el widget de autocompletado, no se requiere ninguna acción adicional (de forma predeterminada, se muestra la atribución necesaria).
- Si recuperas y muestras información adicional del lugar después de obtener un lugar por ID, también debes mostrar atribuciones de terceros.
Para obtener más detalles, consulta la documentación sobre atribuciones.
Optimización de Place Autocomplete
En esta sección, se describen algunas prácticas recomendadas que te ayudarán a aprovechar al máximo el servicio Place Autocomplete.
A continuación, se indican algunos lineamientos generales:
- La forma más rápida de desarrollar una interfaz de usuario funcional es usar el widget de Autocomplete de la API de Maps JavaScript, el widget de Autocomplete del SDK de Places para Android o el control de la IU de Autocomplete del SDK de Places para iOS.
- Comprende los campos de datos esenciales de Place Autocomplete desde el principio.
- Los campos de restricción y personalización de la ubicación son opcionales, pero pueden afectar significativamente el rendimiento del autocompletado.
- Usa el procedimiento de manejo de errores para asegurarte de que tu app administre el problema de forma adecuada si la API muestra un error.
- Asegúrate de que tu app gestione correctamente los problemas cuando no haya selección y ofrezca a los usuarios una manera de continuar.
Prácticas recomendadas para la optimización de los costos
Optimización básica de los costos
Para optimizar el costo de usar el servicio Place Autocomplete, usa máscaras de campo en los widgets de Place Details y Place Autocomplete, que te permiten mostrar solo los campos de datos de lugar que necesitas.
Optimización avanzada de los costos
Considera utilizar la implementación programática de Place Autocomplete para acceder a los precios por pedido y solicitar resultados de la API de Geocoding sobre el lugar seleccionado en lugar de utilizar Place Details. Los precios por pedido asociados con la API de Geocoding son más rentables que los precios por sesión (basados en sesión) si se cumplen las siguientes condiciones:
- Si solo necesitas las coordenadas de latitud y longitud, o la dirección del lugar seleccionado por el usuario, la API de Geocoding proporciona esta información de manera más fácil que una llamada a Place Details.
- Si los usuarios seleccionan una predicción de autocompletar con un promedio de cuatro solicitudes o menos, el precio por solicitud puede ser más rentable que el precio por sesión.
¿Tu aplicación requiere algún dato diferente de la dirección y las coordenadas de latitud o longitud de la predicción seleccionada?
Sí, necesita más detalles.
Usa el servicio Place Autocomplete basado en sesiones con Place Details.
Dado que tu aplicación requiere datos de Place Details, como el nombre del lugar, el estado de la empresa o el horario de atención, tu implementación de Place Autocomplete debe usar un token de sesión (programático o integrado en los widgets de JavaScript, Android o iOS) por un costo total de USD 0.017 por sesión más los SKUs de datos de Places aplicables según los campos de datos de lugar que solicites.1
Implementación de widgets
La administración de sesiones está integrada automáticamente en los widgets de JavaScript, Android o iOS. Esto incluye las solicitudes de Place Autocomplete y Place Details en la predicción seleccionada. Asegúrate de especificar el parámetro fields para asegurarte de solicitar únicamente los campos de datos de lugar que necesitas.
Implementación programática
Usa un token de sesión con tus solicitudes de Place Autocomplete. Cuando solicites la predicción seleccionada a Place Details, incluye los siguientes parámetros:
- El ID de lugar de la respuesta de Place Autocomplete
- El token de sesión que se utilizó en la solicitud de Place Autocomplete
- El parámetro
fieldsque especifica los campos de datos de lugar que necesitas
No, solo requiere la dirección y la ubicación.
La API de Geocoding podría ser una opción más rentable que Place Details para tu aplicación, según el rendimiento de su uso de Place Autocomplete. La eficiencia de Autocomplete de cada aplicación varía según las búsquedas que ingresan los usuarios, dónde se usa la aplicación y si se siguen las prácticas recomendadas de optimización del rendimiento.
Para responder la siguiente pregunta, analiza cuántos caracteres escribe un usuario en promedio antes de seleccionar una predicción de Place Autocomplete en tu aplicación.
¿Tus usuarios seleccionan, en promedio, una predicción de Place Autocomplete cada cuatro solicitudes o menos?
Sí
Implementa Place Autocomplete de manera programática sin tokens de sesión y llama a la API de Geocoding en la predicción de lugar seleccionada.
La API de Geocoding proporciona direcciones y coordenadas de latitud y longitud por USD 0.005 por solicitud. Realizar cuatro solicitudes de Place Autocomplete por solicitud cuesta USD 0.01132, por lo que el costo total de cuatro solicitudes más una llamada a la API de Geocoding sobre la predicción de lugar seleccionada sería de USD 0.01632, lo cual es inferior al precio del autocompletado por sesión, que es de USD 0.017.1
Considera aplicar las prácticas recomendadas de rendimiento para ayudar a los usuarios a obtener la predicción que buscan con menos caracteres.
No
Usa el servicio Place Autocomplete basado en sesiones con Place Details.
Dado que la cantidad promedio de solicitudes que esperas hacer antes de que un usuario seleccione una predicción de Place Autocomplete supera el costo del precio por sesión, la implementación de Place Autocomplete debe usar un token de sesión para las solicitudes de Place Autocomplete y la solicitud de Place Details asociada por un costo total de USD 0.017 por sesión.1
Implementación de widgets
La administración de sesiones está integrada automáticamente en los widgets de JavaScript, Android o iOS. Esto incluye las solicitudes de Place Autocomplete y Place Details en la predicción seleccionada. Asegúrate de especificar el parámetro fields para asegurarte de solicitar únicamente campos de datos básicos.
Implementación programática
Usa un token de sesión con tus solicitudes de Place Autocomplete. Cuando solicites la predicción seleccionada a Place Details, incluye los siguientes parámetros:
- El ID de lugar de la respuesta de Place Autocomplete
- El token de sesión que se utilizó en la solicitud de Place Autocomplete
- El parámetro
fieldsque especifica campos de datos básicos, como la dirección y la geometría
Considera retrasar las solicitudes de Place Autocomplete
Puedes emplear estrategias como demorar una solicitud de Place Autocomplete hasta que el usuario escriba los primeros tres o cuatro caracteres a fin de que tu aplicación realice menos solicitudes. Por ejemplo, cuando se realizan solicitudes de Place Autocomplete para cada carácter después de que el usuario escribe el tercer carácter, si el usuario escribe siete caracteres y luego selecciona una predicción para la cual haces una solicitud a la API de Geocoding, el costo total será de USD 0.01632 (4 * USD 0.00283 (autocompletado por solicitud) + USD 0.005 (Geocoding)).1
Si retrasar las solicitudes puede hacer que tu solicitud programática promedio sea inferior a cuatro, puedes seguir las instrucciones para implementar Place Autocomplete con la API de Geocoding y obtener un rendimiento optimizado. Ten en cuenta que demorar las solicitudes puede percibirse como latencia por parte del usuario, que tal vez espere ver predicciones con cada letra que ingresa.
Considera seguir las prácticas recomendadas de rendimiento para ayudar a los usuarios a obtener la predicción que buscan con menos caracteres.
-
Los costos se indican en USD. Consulta la página Facturación de Google Maps Platform para obtener información completa sobre los precios.
Prácticas recomendadas para mejorar el rendimiento
Los siguientes lineamientos describen maneras de optimizar el rendimiento de Place Autocomplete:
- Agrega restricciones por país, personalización de la ubicación y, en el caso de las implementaciones programáticas, la preferencia de idioma a la implementación de Place Autocomplete. La preferencia de idioma no es necesaria para los widgets, dado que toman esta información del navegador o el dispositivo móvil del usuario.
- Si Place Autocomplete cuenta con un mapa, puedes personalizar la ubicación según su viewport.
- En las situaciones en que un usuario no elige una de las predicciones de Autocomplete, generalmente, porque ninguna de ellas indica el resultado deseado, puedes reutilizar la entrada original del usuario para tratar de obtener resultados más relevantes:
- Si esperas que el usuario ingrese únicamente información sobre la dirección, vuelve a usar su entrada original en una llamada a la API de Geocoding.
- Si esperas que el usuario ingrese búsquedas para un lugar específico por nombre o dirección, usa una solicitud de Find Place. Si se espera que los resultados pertenezcan únicamente a una región específica, usa la restricción de ubicación.
- Usuarios que ingresan direcciones con números de departamento en países donde la compatibilidad de Place Autocomplete no es completa (p. ej., República Checa, Estonia y Lituania; así, la dirección checa "Stroupežnického 3191/17, Praha" genera una predicción parcial en Place Autocomplete)
- Los usuarios que ingresan direcciones con prefijos de tramo de ruta, como "23-30 29th St, Queens" en la ciudad de Nueva York o "47-380 Kamehameha Hwy, Kaneohe" en la isla de Kauai en Hawái
Solución de problemas
Si bien puede producirse una gran variedad de errores, es probable que la mayoría de los errores que experimenta tu app se deban a errores de configuración (por ejemplo, si se usó una clave de API incorrecta o la clave de API se configuró de forma incorrecta) o errores de cuota (tu app excedió su cuota). Consulta Límites de uso para obtener más información sobre las cuotas.
Los errores que se producen cuando se usan los controles de autocompletado se muestran en la devolución de llamada onActivityResult(). Llama a Autocomplete.getStatus() para obtener el mensaje de estado del resultado.