Intents de Google Maps para Android

El App de Google Maps para Android expone varios intents que puedes usar para iniciar Google Maps en pantalla. los modos de búsqueda, navegación o Street View. Si quieres incorpora un mapa en tu app, consulta la API de Google Maps para Android Guía de introducción.

Nota: Las URLs de Maps te permiten crear una URL universal multiplataforma para iniciar Google Maps y realizar búsquedas, obtener instrucciones sobre cómo llegar, mostrar vistas de mapa y mostrar imágenes panorámicas. Te recomendamos que uses las URLs de Maps multiplataforma para iniciar Google Maps, ya que estas URLs universales permiten un control más amplio de las solicitudes de mapas sin importar en qué plataforma esté el usuario. Solo debes usar los intents de Maps específicos de Android para las funciones que solo pueden ser funcionales en una plataforma para dispositivos móviles (por ejemplo, la navegación paso a paso).

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. El App de Google Maps para Android admite varios intents diferentes, lo que te permite iniciar la app de Google Maps y realizar una de estas cuatro acciones:

1. Mostrar un mapa en una ubicación y a un nivel de zoom especificados.
2. Busca ubicaciones o lugares y muéstralos en un mapa.
3. Solicitar indicaciones para ir 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.
4. 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 de la plataforma de Android, consulta la documentación para desarrolladores de Android.

Solicitudes de intents

Para iniciar Google Maps con una intención, primero debes crear un objeto Intent y especificar su acción, su URI y el paquete.

• Acción: Todos los intents de Google Maps se denominan una acción de vista. ACTION_VIEW
• URI: Los intents de Google Maps usan URL codificadas que especifican junto con algunos datos para realizar la acción.
• Paquete: Llamar a setPackage("com.google.android.apps.maps") asegurarte de que la app de Google Maps para Android maneje el intent. Si el botón no está configurado, el sistema determinará qué aplicaciones pueden Intent Si hay varias apps disponibles, es posible que se le pregunte al usuario cuál de ellas que les gustaría usar.

Después de crear el Intent, puedes solicitar que el sistema inicie el elemento aplicación de varias maneras. Un método común es pasar el Intent al método startActivity(). El sistema lanzará 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 responda a la intención, es posible que tu app falle. Por esta razón, primero debes verificar que se instale una aplicación receptora antes de presentar una de estas intenciones a un usuario.

Para verificar que una app esté disponible para recibir el intent, llama a resolveActivity() en tu Intent . Si el resultado no es nulo, hay al menos una app que puede administrar la intent y es seguro llamar a startActivity(). Si el resultado es null, no debes usar la intent y, si es posible, debes inhabilitar la función que la 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 cadena "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 parse() de android.net.Uri para codificar tus cadenas. 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 con un nivel de zoom especificados.

geo:latitude,longitude?z=zoom

Parámetros

• latitude y longitude establecen el punto central del mapa.
• De manera opcional, z establece el nivel de zoom inicial del mapa. Rango de valores aceptados de 0 (todo el mundo) a 21 (edificios individuales). El límite superior puede varían en función de los datos del mapa disponibles para 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)

Cómo buscar una ubicación

Usa esta intención para mostrar solicitudes de búsqueda dentro de un viewport especificado. Cuando búsqueda tiene un solo resultado, puedes usar esta intent para mostrar un marcador a un lugar o una dirección particulares, como un punto de referencia, una empresa, un accidente 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ámetro q es obligatorio para todas las solicitudes de búsqueda. Acepta una ubicación como un lugar nombre o dirección. La cadena debe estar codificada como URL, de modo que una dirección como “City Hall, New York, NY” se debe convertir en City+Hall,New+York,NY.

• label te permite establecer una etiqueta personalizada en un lugar identificado en el mapa. El label debe especificarse como una cadena.

Búsqueda categórica

Si pasas un término general, Google Maps intentará hallar una ubicación cerca de la latitud y longitud especificada por ti 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 búsqueda especificando un parámetro de zoom junto por la cadena de consulta. En el siguiente ejemplo, con un zoom de 10, se intentará para encontrar restaurantes a nivel de ciudad en lugar de cerca.

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 establecen valores de latitud y longitud de 0,0, pero se pasa una dirección como una cadena de consulta. Al buscar una ubicación muy específica, no se necesitan valores de latitud y longitud. Sin embargo, si no sabes la dirección exacta, puedes intenten personalizar los resultados de la búsqueda especificando una coordenada. Por ejemplo, una búsqueda de “Calle principal” devolverá 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 se agrega un valor de latitud y longitud al URI de la intención, se restringirá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 devolverá un solo valor, quizás desees pasar un etiqueta opcional. Las etiquetas deben especificarse como un elemento String, y aparecerán debajo del marcador de mapa. Ten en cuenta que las etiquetas solo se encuentran disponibles cuando q se especifica 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 una latitud/longitud, puedes mostrar un pin en una ubicación conocida con un código plus.

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

Iniciar la navegación paso a paso

Usar esta intención para iniciar la navegación de Google Maps con instrucciones paso a paso a la dirección o coordenada especificada. Las instrucciones siempre se proporcionan 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 destino para las búsquedas de navegación. Este valor puede ser latitud, coordenadas de longitud o una dirección con formato de consulta. Si se trata de una consulta cadena que devuelve más de un resultado, el primer resultado será seleccionado.

• mode establece el método de transporte. El modo es opcional y se puede configurar para una de las siguientes opciones:

  • d para conducir (predeterminado)
  • b en bicicleta
  • l para vehículos motorizados de dos ruedas
  • w a pie

• avoid establece los componentes que la ruta debe intentar evitar. Evitar es opcional y se pueden establecer en una o más de las siguientes opciones:

  • t para peajes
  • h para autopistas
  • f para ferris

Ejemplos

En el siguiente Intent, se solicitará navegación paso a paso hasta el Taronga Zoo, en Sydney, 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 abordar un transbordador, puedes solicitar que en las indicaciones se intente evitarlos.

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 indicaciones para 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 de dos ruedas motorizado, puedes solicitar que las instrucciones incluyan rutas estrechas y senderos no disponibles para automóviles. Se devuelven las siguientes intent una ruta en 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 a lo largo de su área de cobertura. Fotos esféricas enviadas por los usuarios, y Colecciones especiales de Street View también están disponibles.

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á el panorama fotografiado más cerca de esta ubicación. Debido a que las imágenes de Street View se actualizan de manera periódica, y a que las fotografías pueden tomarse desde posiciones ligeramente diferentes en cada ocasión, es posible que tu ubicación se integre a otra panorámica cuando se actualicen las imágenes.

• panoid es un ID de panorama específico. Google Maps utilizará el ID de panorámica si se especifican panoid y cbll. Los IDs de panorama están disponibles para una app para Android desde el objeto StreetViewPanoramaLocation.

• cbp es un parámetro opcional que ajusta la orientación inicial de la cámara. El parámetro cbp toma 5 valores separados por comas, todos de los cuales 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 primero y el tercer valor no son compatibles y deben establecerse en 0.

  • bearing: Indica la orientación de la cámara según la brújula en grados en el sentido de las manecillas del reloj. del norte. El norte geográfico es el grado 0, el este el 90, el sur el 180 y el oeste el 270. Los valores que se pasan al rumbo se unirán, es decir, 0°, 360° y 720° apuntan 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. Se estableció el nivel de zoom predeterminado en 0. Un valor 1 de zoom duplicaría la magnificación. El zoom está fijo entre 0 y el nivel de zoom máximo para la panorámica actual. Esto significa que cualquier valor que quede fuera de este rango se fijará extremo más cercano que se encuentre dentro del rango. Por ejemplo, un valor de -1 se establecerá en 0. El zoom es el cuarto de los cinco valores separados por comas.
  • tilt: Especifica el ángulo, ascendente o descendente, de la cámara. El rango es -90. de 0 a 90, donde 90 apunta directamente hacia abajo y 0 está centrado en el horizonte y -90 mirando hacia arriba.

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)