L'application Google Maps pour Android vous propose plusieurs intents que vous pouvez utiliser pour lancer Google Maps en mode affichage, recherche, navigation ou Street View. Si vous souhaitez intégrer une carte à votre application, consultez le guide de démarrage de l'API Google Maps Android.
Présentation
Les intents vous permettent de démarrer une activité dans une autre application en décrivant une action simple que vous souhaitez effectuer (par exemple, "afficher une carte" ou "afficher l'itinéraire vers l'aéroport") dans un objet Intent
. L'application Google Maps pour Android accepte plusieurs intents différents, ce qui vous permet de lancer l'application Google Maps et d'effectuer l'une des quatre actions suivantes:
- Affichez une carte à un point géographique et à un niveau de zoom donnés.
- rechercher des lieux ou des lieux, et les afficher sur une carte ;
- Demandez un itinéraire d'un endroit à un autre. Les itinéraires peuvent être renvoyés pour trois modes de transport: la voiture, la marche et le vélo.
- Affichez des images panoramiques dans Google Street View.
Cette page décrit les intents que vous pouvez utiliser avec l'application Google Maps pour Android. Pour en savoir plus sur les intents et filtres d'intents ou les intents communs à la plate-forme Android, consultez la documentation destinée aux développeurs Android.
Requêtes d'intent
Pour lancer Google Maps avec un intent, vous devez d'abord créer un objet Intent
, en spécifiant son action, son URI et son package.
- Action: tous les intents Google Maps sont appelés en tant qu'actions View (
ACTION_VIEW
). - URI: les intents Google Maps utilisent un encodage d'URL qui spécifie l'action souhaitée, ainsi que certaines données à l'aide desquelles elle doit effectuer cette action.
- Package: l'appel de
setPackage("com.google.android.apps.maps")
garantit que l'application Google Maps pour Android gère l'intent. Si le package n'est pas défini, le système détermine quelles applications peuvent gérerIntent
. Si plusieurs applications sont disponibles, l'utilisateur peut être invité à choisir celle qu'il souhaite utiliser.
Après avoir créé le Intent
, vous pouvez demander au système de lancer l'application associée de différentes manières. Une méthode courante consiste à transmettre Intent
à la méthode startActivity()
. Le système lance l'application nécessaire (dans ce cas, Google Maps) et démarre le Activity
correspondant.
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 le système ne peut pas identifier une application pouvant répondre à l'intent, elle risque de planter. C'est pourquoi vous devez d'abord vérifier qu'une application destinataire est installée avant de présenter l'un de ces intents à un utilisateur.
Pour vérifier qu'une application est disponible pour recevoir l'intent, appelez resolveActivity()
sur votre objet Intent
. Si le résultat n'est pas une valeur nulle, cela signifie qu'au moins une application peut gérer l'intent et que vous pouvez appeler startActivity()
en toute sécurité.
Si le résultat est null
, vous ne devez pas utiliser l'intent. Si possible, vous devez désactiver la fonctionnalité qui appelle l'intent.
Java
if (mapIntent.resolveActivity(getPackageManager()) != null) { ... }
Kotlin
mapIntent.resolveActivity(packageManager)?.let { ... }
Par exemple, pour afficher une carte de San Francisco, vous pouvez utiliser le code suivant :
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) }
Chaînes de requête encodées au format URL
Toutes les chaînes transmises aux intentions Google Maps doivent être encodées sous forme d'URI. Par exemple, la chaîne "1st & Pike, Seattle" doit devenir 1st%20%26%20Pike%2C%20Seattle
.
Dans la chaîne, les espaces peuvent être encodés avec %20 ou remplacés par le signe plus (+).
Vous pouvez utiliser la méthode android.net.Uri
parse()
pour encoder vos chaînes.
Exemple :
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"))
Afficher une carte
Utilisez l'intent geo:
pour afficher une carte à un point géographique et à un niveau de zoom donnés.
geo:latitude,longitude?z=zoom
Paramètres
latitude
etlongitude
définissent le point central de la carte.z
définit éventuellement le niveau de zoom initial de la carte. Les valeurs acceptées sont comprises entre 0 (monde entier) et 21 (bâtiments individuels). La limite supérieure peut varier en fonction des données cartographiques disponibles à l'emplacement sélectionné.
Exemples
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)
Recherche d'un lieu
Utilisez cette intention pour afficher des requêtes de recherche au sein de la fenêtre d'affichage spécifiée. Lorsque la requête n'a qu'un seul résultat, vous pouvez utiliser cet intent pour afficher un repère à un lieu ou à une adresse spécifiques, comme un point de repère, un établissement, un élément géographique ou une ville.
geo:latitude,longitude?q=query geo:0,0?q=my+street+address geo:0,0?q=latitude,longitude(label)
Paramètres
En plus des paramètres utilisés pour afficher une carte, la recherche prend en charge les paramètres suivants:
q
définit le ou les lieux à mettre en évidence sur la carte. Le paramètreq
est obligatoire pour toutes les requêtes de recherche. Il accepte un lieu sous la forme d'un nom ou d'une adresse de lieu. La chaîne doit être encodée au format URL. Par conséquent, une adresse telle que "Hôtel de ville, New York, NY" doit être convertie en City+Hall,New+York,NY.label
vous permet de définir un libellé personnalisé à un lieu identifié sur la carte.label
doit être spécifié sous forme de chaîne.
Recherche par catégorie
Si vous spécifiez un terme de recherche général, Google Maps essaiera de trouver un lieu proche des coordonnées de latitude et de longitude que vous avez indiquées. Si aucun lieu n'est spécifié, Google Maps tente de trouver des fiches à proximité. Exemple :
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)
Vous pouvez affiner les résultats de recherche en spécifiant un paramètre de zoom avec la chaîne de requête. Dans l'exemple ci-dessous, l'ajout d'un zoom de 10 essaie de trouver des restaurants au niveau de la ville et non à proximité.
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)
Recherche de lieux
La recherche d'une adresse spécifique affiche un repère sur ce lieu.
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)
L'exemple ci-dessus définit une latitude/longitude de 0
,0
, mais transmet une adresse en tant que chaîne de requête. Lorsque vous recherchez un lieu très spécifique, la latitude et la longitude ne sont pas requises. Toutefois, si vous ne connaissez pas l'adresse exacte, vous pouvez essayer de pondérer les résultats de la recherche en spécifiant une coordonnée. Par exemple, si vous recherchez "Main Street", la recherche renvoie trop de résultats.
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")
L'ajout d'une latitude/longitude à l'URI d'intent influence les résultats par rapport à une zone particulière:
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)
Si vous savez que votre recherche renvoie une seule valeur, vous pouvez transmettre un libellé facultatif. Les libellés doivent être spécifiés sous forme de chaîne et apparaissent sous le repère de la carte. Notez que les libellés ne sont disponibles que lorsque q
est spécifié en tant que coordonnée de latitude/longitude.
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)
Au lieu d'une adresse postale ou d'une latitude/longitude, vous pouvez afficher un repère à un emplacement connu à l'aide d'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
Lancer la navigation détaillée
Utilisez cet intent pour lancer la navigation Google Maps avec la navigation détaillée vers l'adresse ou les coordonnées spécifiées. L'itinéraire est toujours fourni à partir de la position actuelle de l'utilisateur.
google.navigation:q=a+street+address google.navigation:q=latitude,longitude
Paramètres
q
: définit le point d'arrivée des recherches sur la navigation. Cette valeur peut être une latitude, des coordonnées de longitude ou une adresse au format requête. S'il s'agit d'une chaîne de requête qui renvoie plusieurs résultats, le premier résultat est sélectionné.mode
définit le mode de transport. Le mode est facultatif et peut être défini sur l'une des valeurs suivantes:d
en voiture (par défaut)b
à vélol
pour les deux-rouesw
à pied
avoid
définit les éléments géographiques que l'itinéraire doit essayer d'éviter. "À éviter" est facultatif et peut être défini sur une ou plusieurs des valeurs suivantes:t
pour les péagesh
pour autoroutesf
pour les ferries
Exemples
Le Intent
ci-dessous demande une navigation détaillée vers le zoo de Taronga, à Sydney en Australie:
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 vous préférez ne pas payer de péages ni prendre de ferry, vous pouvez demander un itinéraire qui évite ces événements.
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 vous préférez faire de l'exercice, vous pouvez demander un itinéraire à vélo.
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 vous préférez un véhicule deux-roues motorisé, vous pouvez demander que les itinéraires incluent des routes étroites et des sentiers non accessibles aux voitures. Le intent
ci-dessous renvoie un itinéraire en Inde.
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)
Afficher un panorama Street View
Utilisez l'intent google.streetview
pour lancer Google Street View. Google Street View offre des vues panoramiques à partir d'emplacements désignés dans sa zone de couverture.
Des sphères de photo fournies par les utilisateurs et des collections spéciales Street View sont également disponibles.
google.streetview:cbll=latitude,longitude&cbp=0,bearing,0,zoom,tilt google.streetview:panoid=id&cbp=0,bearing,0,zoom,tilt
Paramètres
Tous les URI google.streetview
doivent inclure un paramètre cbll
ou panoid
.
cbll
accepte une latitude et une longitude en tant que valeurs séparées par une virgule (46.414382,10.013988
). L'application affiche le panorama photographié le plus proche de ce lieu. Étant donné que les images Street View sont régulièrement actualisées et que les photos peuvent être prises à des positions légèrement différentes à chaque fois, il est possible que votre position s'aligne sur un autre panorama lorsque les images sont mises à jour.panoid
est un ID de panorama spécifique. Google Maps utilise l'identifiant de panorama si les élémentspanoid
etcbll
sont spécifiés. Les ID de panorama sont disponibles pour une application Android à partir de l'objetStreetViewPanoramaLocation
.cbp
est un paramètre facultatif qui ajuste l'orientation initiale de la caméra. Le paramètrecbp
accepte cinq valeurs séparées par une virgule, toutes facultatives. Les valeurs les plus importantes sont les deuxième, quatrième et cinquième valeurs qui définissent respectivement l'orientation, le zoom et l'inclinaison. Les première et troisième valeurs ne sont pas acceptées et doivent être définies sur0
.bearing
: indique la direction de la boussole de la caméra en degrés dans le sens des aiguilles d'une montre, à partir du nord. Le nord géographique est à 0, l'est à 90, le sud à 180 et l'ouest à 270. Les valeurs transmises à l'orientation seront encapsulées, c'est-à-dire que 0°, 360° et 720° pointent tous dans la même direction. L'orientation est la deuxième des cinq valeurs séparées par une virgule.zoom
: définit le niveau de zoom de l'appareil photo. Le niveau de zoom par défaut est défini sur 0. Un zoom de 1 double l'agrandissement. Le zoom est limité entre 0 et le niveau de zoom maximal pour le panorama en cours. Cela signifie que toute valeur non comprise dans cette plage sera définie sur l'extrême le plus proche Par exemple, la valeur -1 est définie sur 0. Le zoom est le quatrième des cinq valeurs séparées par une virgule.tilt
: spécifie l'angle de la caméra (vers le haut ou vers le bas). Les valeurs sont comprises entre -90 et 0 et entre 0 et 90, avec 90 à la verticale vers le bas, 0 centré sur l'horizon et -90 à la verticale vers le haut.
Exemples
Vous trouverez ci-dessous quelques exemples d'utilisation de l'intention 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)