La app de Google Maps para Android expone varios intents que puedes usar para iniciar Google Maps en los modos de visualización, búsqueda, navegación o Street View. Si deseas incorporar un mapa en tu app, consulta la Guía de introducción de la API de Google Maps para Android.
Descripción general
Los intents te permiten iniciar una actividad en otra app mediante la descripción de una acción simple que quieras realizar (como "mostrar un mapa" o "mostrar instrucciones sobre cómo llegar al aeropuerto") en un objeto Intent
. La app de Google Maps para Android admite varios intents diferentes, lo que te permite iniciar la app de Google Maps y realizar una de las siguientes cuatro acciones:
- Muestra un mapa en una ubicación y a un nivel de zoom especificados.
- Busca ubicaciones o lugares, y muéstralos en un mapa.
- Solicita instrucciones sobre cómo llegar de una ubicación a otra. Se pueden mostrar instrucciones sobre cómo llegar para tres medios de transporte: en automóvil, a pie y en bicicleta.
- Muestra imágenes panorámicas en Google Street View.
En esta página, se describen los intents que puedes usar con la app de Google Maps para Android. Para obtener más información sobre Intents y filtros de intents, o Intents comunes a la plataforma de Android, consulta la documentación para desarrolladores de Android.
Solicitudes de intent
Para iniciar Google Maps con un intent, primero debes crear un objeto Intent
y especificar su acción, URI y paquete.
- Acción: Todos los intents de Google Maps se llaman como una acción de vista:
ACTION_VIEW
. - URI: Los intents de Google Maps usan una URL codificada que especifica una acción deseada, junto con algunos datos con los que se debe realizar la acción.
- Paquete: Llamar a
setPackage("com.google.android.apps.maps")
garantizará que la app de Google Maps para Android controle el intent. Si no está configurado, el sistema determinará qué apps pueden controlar laIntent
. Si hay varias apps disponibles, se le puede preguntar al usuario cuál desea usar.
Después de crear el Intent
, puedes solicitar que el sistema inicie la app relacionada de varias maneras. Un método común es pasar Intent
al método startActivity()
. El sistema iniciará la app necesaria, en este caso, Google Maps, e iniciará el Activity
correspondiente.
Java
// Create a Uri from an intent string. Use the result to create an Intent. Uri gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988"); // Create an Intent from gmmIntentUri. Set the action to ACTION_VIEW Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); // Make the Intent explicit by setting the Google Maps package mapIntent.setPackage("com.google.android.apps.maps"); // Attempt to start an activity that can handle the Intent startActivity(mapIntent);
Kotlin
// Create a Uri from an intent string. Use the result to create an Intent. val gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988") // Create an Intent from gmmIntentUri. Set the action to ACTION_VIEW val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) // Make the Intent explicit by setting the Google Maps package mapIntent.setPackage("com.google.android.apps.maps") // Attempt to start an activity that can handle the Intent startActivity(mapIntent)
Si el sistema no puede identificar una app que pueda responder al intent, es posible que tu app falle. Por este motivo, primero debes verificar que una aplicación receptora esté instalada antes de presentar uno de estos intents a un usuario.
A fin de verificar que una app esté disponible para recibir el intent, llama a resolveActivity()
en tu objeto Intent
. Si el resultado no es nulo, hay al menos una app que puede controlar el intent y es seguro llamar a startActivity()
.
Si el resultado es null
, no debes usar el intent y, si es posible, debes inhabilitar la función que lo invoca.
Java
if (mapIntent.resolveActivity(getPackageManager()) != null) { ... }
Kotlin
mapIntent.resolveActivity(packageManager)?.let { ... }
Por ejemplo, para mostrar un mapa de San Francisco puedes usar el siguiente código:
Java
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); if (mapIntent.resolveActivity(getPackageManager()) != null) { startActivity(mapIntent); }
Kotlin
val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") mapIntent.resolveActivity(packageManager)?.let { startActivity(mapIntent) }
Cadenas de consulta codificadas para URL
Todas las cadenas pasadas a las intenciones de Google Maps deben tener codificación de URI. Por ejemplo, la string "1st & Pike, Seattle" debe convertirse en 1st%20%26%20Pike%2C%20Seattle
.
Los espacios de la cadena pueden codificarse con %20 o reemplazarse con el signo más (+).
Puedes usar el método android.net.Uri
parse()
para codificar tus strings.
Por ejemplo:
Java
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4192?q=" + Uri.encode("1st & Pike, Seattle"));
Kotlin
val gmmIntentUri = Uri.parse("geo:37.7749,-122.4192?q=" + Uri.encode("1st & Pike, Seattle"))
Muestra de un mapa
Usa el intent geo:
para mostrar un mapa en una ubicación y un nivel de zoom especificados.
geo:latitude,longitude?z=zoom
Parámetros
latitude
ylongitude
establecen el punto central del mapa.- De forma opcional,
z
establece el nivel de zoom inicial del mapa. Los valores aceptados varían de 0 (todo el mundo) a 21 (edificios individuales). El límite superior puede variar según los datos del mapa disponibles en la ubicación seleccionada.
Ejemplos
Java
// Creates an Intent that will load a map of San Francisco Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Creates an Intent that will load a map of San Francisco val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Buscando una ubicación
Usa esta intención para mostrar solicitudes de búsqueda dentro de un viewport especificado. Cuando la consulta tiene un solo resultado, puedes usar este intent para mostrar un marcador en un lugar o una dirección en particular, como un punto de referencia, una empresa, un componente geográfico o una ciudad.
geo:latitude,longitude?q=query geo:0,0?q=my+street+address geo:0,0?q=latitude,longitude(label)
Parámetros
Además de los parámetros que se usan para mostrar un mapa, la Búsqueda admite los siguientes parámetros:
q
define los lugares que se deben destacar en el mapa. El parámetroq
es obligatorio para todas las solicitudes de búsqueda. Acepta una ubicación como el nombre o la dirección de un lugar. La string debe estar codificada como una URL, por lo que una dirección como “City Hall, New York, NY” debe convertirse en City+Hall,New+York,NY.label
te permite establecer una etiqueta personalizada en un lugar identificado en el mapa.label
debe especificarse como una cadena.
Búsqueda categórica
Si pasas un término de búsqueda general, Google Maps intentará encontrar una ubicación cercana a la latitud y longitud que especificaste y que coincida con tus criterios. Si no se especifica una ubicación, Google Maps intentará encontrar fichas cercanas. Por ejemplo:
Java
// Search for restaurants nearby Uri gmmIntentUri = Uri.parse("geo:0,0?q=restaurants"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent); // Search for restaurants in San Francisco Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=restaurants"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Search for restaurants nearby val gmmIntentUri = Uri.parse("geo:0,0?q=restaurants") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent) // Search for restaurants in San Francisco val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=restaurants") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Puedes personalizar aún más los resultados de la búsqueda si especificas un parámetro de zoom junto con la cadena de consulta. En el siguiente ejemplo, si agregas un zoom de 10, se intentará encontrar restaurantes al nivel de la ciudad en lugar de cercanos.
Java
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Búsqueda de ubicación
La búsqueda de una dirección específica hará que se muestre una marca en dicha ubicación.
Java
Uri gmmIntentUri = Uri.parse("geo:0,0?q=1600 Amphitheatre Parkway, Mountain+View, California"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("geo:0,0?q=1600 Amphitheatre Parkway, Mountain+View, California") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
En el ejemplo anterior, se establece un valor de latitud y longitud de 0
, 0
, pero se pasa una dirección como una cadena de consulta. Cuando se busca una ubicación muy específica, la latitud y la longitud no son obligatorias. Sin embargo, si no conoces la dirección exacta, puedes intentar personalizar los resultados de la búsqueda especificando una coordenada. Por ejemplo, realizar una búsqueda de "Calle Principal" mostrará demasiados resultados.
Java
// Searching for 'Main Street' will return too many results Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");
Kotlin
// Searching for 'Main Street' will return too many results val gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street")
Si agregas un valor de latitud y longitud al URI del intent, se personalizarán los resultados de un área en particular:
Java
// Searches for 'Main Street' near San Francisco Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Searches for 'Main Street' near San Francisco val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Cuando sepas que tu búsqueda mostrará un solo valor, te recomendamos pasar una etiqueta opcional. Las etiquetas deben especificarse como una cadena y aparecerán debajo del marcador de mapa. Ten en cuenta que las etiquetas solo están disponibles cuando se especifica q
como una coordenada de latitud y longitud.
Java
// Display a label at the location of Google's Sydney office Uri gmmIntentUri = Uri.parse("geo:0,0?q=Google+Sydney@-33.8666,151.1957"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Display a label at the location of Google's Sydney office val gmmIntentUri = Uri.parse("geo:0,0?q=-33.8666,151.1957(Google+Sydney)") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Como alternativa a una dirección o a las coordenadas de latitud y longitud, puedes mostrar un pin en una ubicación conocida mediante un Plus Code.
Java
// Display the location of Google, San Francisco using a global plus code. Uri gmmIntentUri = Uri.parse("http://plus.codes/849VQJQ5+XX"); // Equivalently, define the same location using a local plus code gmmIntentUri = Uri.parse("https://plus.codes/QJQ5+XX,San%20Francisco"); // Construct and use the Intent as in the examples above
Kotlin
// Display the location of Google, San Francisco using a global plus code. var gmmIntentUri = Uri.parse("http://plus.codes/849VQJQ5+XX") // Equivalently, define the same location using a local plus code gmmIntentUri = Uri.parse("https://plus.codes/QJQ5+XX,San%20Francisco") // Construct and use the Intent as in the examples above
Cómo iniciar la navegación paso a paso
Usa este intent para iniciar la navegación de Google Maps con instrucciones paso a paso sobre cómo llegar a la dirección o las coordenadas especificadas. Las indicaciones siempre se dan desde la ubicación actual del usuario.
google.navigation:q=a+street+address google.navigation:q=latitude,longitude
Parámetros
q
: Establece el punto de finalización para las búsquedas de navegación. Este valor puede ser de latitud y longitud, o una dirección con formato de consulta. Si es una cadena de consulta que muestra más de un resultado, se seleccionará el primer resultado.mode
establece el medio de transporte. El modo es opcional y se puede establecer en una de las siguientes opciones:d
en auto (predeterminado)b
en bicicletal
en vehículo motorizado de dos ruedasw
a pie
avoid
establece elementos que la ruta debe evitar. Evita es opcional y se puede establecer en una o más de las siguientes opciones:t
para peajesh
para autopistasf
en transbordadores
Ejemplos
En el siguiente Intent
, se solicitará navegación paso a paso hasta el Taronga Zoo en Sídney, Australia:
Java
Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Si prefieres no pagar peajes ni viajar en transbordador, puedes solicitar que en la planificación de ruta se intente evitar esos problemas.
Java
Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Si prefieres hacer ejercicio, puedes solicitar instrucciones sobre cómo llegar en bicicleta.
Java
Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&mode=b"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&mode=b") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Si prefieres usar un vehículo motorizado de dos ruedas, puedes solicitar que las instrucciones sobre cómo llegar incluyan rutas estrechas y senderos no disponibles para automóviles. El siguiente intent
muestra una ruta en la India.
Java
Uri gmmIntentUri = Uri.parse("google.navigation:q=Connaught+Place,+New+Delhi,Delhi&mode=l"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
val gmmIntentUri = Uri.parse("google.navigation:q=Connaught+Place,+New+Delhi,Delhi&mode=l") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)
Cómo mostrar una panorámica de Street View
Usa el intent google.streetview
para iniciar Google Street View. Google Street View proporciona vistas panorámicas de ubicaciones designadas en su área de cobertura.
También se encuentran disponibles fotos esféricas aportadas por los usuarios y recopilaciones especiales de Street View.
google.streetview:cbll=latitude,longitude&cbp=0,bearing,0,zoom,tilt google.streetview:panoid=id&cbp=0,bearing,0,zoom,tilt
Parámetros
Todos los URIs de google.streetview
deben incluir un parámetro cbll
o panoid
.
cbll
acepta una latitud y una longitud como valores separados por comas (46.414382,10.013988
). La app mostrará la panorámica más cercana a esa ubicación. Debido a que las imágenes de Street View se actualizan periódicamente y que las fotografías pueden tomarse desde posiciones ligeramente diferentes en cada ocasión, es posible que tu ubicación se adapte a una panorámica diferente cuando se actualicen las imágenes.panoid
es un ID de panorámica específico. Google Maps utilizará el ID de panorámica si se especifican un objetopanoid
y uncbll
. Los IDs de panorámica están disponibles para una app para Android desde el objetoStreetViewPanoramaLocation
.cbp
es un parámetro opcional que ajusta la orientación inicial de la cámara. El parámetrocbp
toma 5 valores separados por comas, que son opcionales. Los valores más significativos son el segundo, el cuarto y el quinto, que establecen el rumbo, el zoom y la inclinación, respectivamente. El primer y el tercer valor no son compatibles y deben establecerse en0
.bearing
: Indica la orientación de la cámara según la brújula en grados y en sentido horario desde el norte. El norte geográfico es el grado 0, el este el 90, el sur el 180 y el oeste el 270. Los valores pasados al rumbo se unirán, es decir, los valores de 0°, 360° y 720° apuntarán en la misma dirección. El rumbo se define como el segundo de cinco valores separados por comas.zoom
: Establece el nivel de zoom de la cámara. El nivel de zoom predeterminado es 0. Un valor de 1 duplicaría la ampliación. El zoom se encuentra fijo entre 0 y el nivel máximo para la panorámica actual. Esto significa que cualquier valor que se encuentre fuera de este rango se establecerá en el extremo más cercano que esté dentro del rango. Por ejemplo, un valor de -1 se establecerá en 0. El zoom es el cuarto de cinco valores separados por comas.tilt
: Especifica el ángulo, ascendente o descendente, de la cámara. El rango es de -90 a 0 a 90, donde 90 representa la posición extrema inferior, 0 la posición centrada en el horizonte y -90 la posición extrema superior.
Ejemplos
A continuación se proporcionan algunos ejemplos de uso de la intención de Street View.
Java
// Displays an image of the Swiss Alps Uri gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent); // Uses a PanoID to show an image from Maroubra beach in Sydney, Australia Uri gmmIntentUri = Uri.parse("google.streetview:panoid=Iaa2JyfIggYAAAQfCZU9KQ"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent); // Opens Street View between two Pyramids in Giza. The values passed to the // cbp parameter will angle the camera slightly up, and towards the east. Uri gmmIntentUri = Uri.parse("google.streetview:cbll=29.9774614,31.1329645&cbp=0,30,0,0,-15"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri); mapIntent.setPackage("com.google.android.apps.maps"); startActivity(mapIntent);
Kotlin
// Displays an image of the Swiss Alps val gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent) // Uses a PanoID to show an image from Maroubra beach in Sydney, Australia val gmmIntentUri = Uri.parse("google.streetview:panoid=Iaa2JyfIggYAAAQfCZU9KQ") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent) // Opens Street View between two Pyramids in Giza. The values passed to the // cbp parameter will angle the camera slightly up, and towards the east. val gmmIntentUri = Uri.parse("google.streetview:cbll=29.9774614,31.1329645&cbp=0,30,0,0,-15") val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri) mapIntent.setPackage("com.google.android.apps.maps") startActivity(mapIntent)