Implémentation de cartes dans .NET MAUI

Apprenez à ajouter des cartes à vos applications .NET MAUI de manière très simple et rapide, avec l’interface IMap.

Salut! À un moment donné de votre vie de développeur, vous avez probablement eu besoin d’ajouter des cartes à vos applications. Il s’agit d’une exigence très courante à laquelle vous devez être prêt à faire face. C’est pourquoi, dans cet article, je vais vous apprendre à ajouter des cartes à votre .NET FIXE applications d’une manière très rapide et facile, tout cela grâce à la IMap interface.

Paramètres par plate-forme

Pour être sûr que les cartes sont correctement intégrées dans notre application, nous devons nous assurer d’avoir des configurations appropriées. C’est pourquoi je vous laisse l’ensemble des instructions que vous devez appliquer pour chaque plate-forme.

Android

Pour lancer l’application Maps, Android utilise le schéma d’URI géo, qui permettra à l’utilisateur d’utiliser n’importe quelle application déjà installée sur l’appareil qui prend en charge ce schéma d’URI.

Aller à Plateformes ➡ Android ➡ AndroidManifest.xml file et à l’intérieur des nœuds Manifest, ajoutez ce qui suit :

<queries>
    <intent>
	    <action android:name="android.intent.action.VIEW" />
	    <data android:scheme="geo"/>
    </intent>
</queries>

les fenêtres

Aucune configuration n’est requise.

iOS/macOS

Aucune configuration n’est requise.

Comment fonctionnent les cartes dans .NET MAUI ?

.NET MAUI a le IMap interface disponible, qui permet à vos applications d’ouvrir vos applications cartographiques installées avec des données spécifiques telles qu’un repère ou un emplacement spécifique. Il est contenu dans le Microsoft.Maui.ApplicationModel espace de noms et vous pouvez l’utiliser via le Map.Default la propriété.

Comment puis-je ouvrir une carte ?

Pour ouvrir une carte, vous devez utiliser le OpenAsync méthode. Celui-ci contient six surcharges. Dans cet article, nous allons définir tous les paramètres qui acceptent ses différentes surcharges et au final vous n’aurez plus qu’à sélectionner ceux qui s’adaptent à la surcharge de votre choix.

Avant de passer à l’explication des paramètres, regardons les options de surcharge disponibles.

Paramètres que vous devez connaître

Continuons à expliquer les paramètres.

Lieu: Cette valeur est composée de la latitude et de la longitude de l’adresse que vous souhaitez ouvrir dans Maps.

var location = new Location(18.481077500388174, -69.918856715392);

Repère : Il vous offre des informations plus détaillées sur l’emplacement de votre carte, telles que le nom du pays, l’artère, la localité, entre autres. Voyons un exemple de la façon de le faire:

var placemark = new Placemark
{ 
	CountryName = "Dominican Republic",
	AdminArea = "SD",
	Thoroughfare = "National Theater",
	Locality = "Esperilla",
	CountryCode = "10204"
};

Latitude: C’est une valeur Double qui reçoit une latitude comme valeur.

Example: 47.645160

Longitude: C’est une valeur Double qui reçoit comme valeur une longitude.

Example: -122.1306032

Options de lancement de la carte : Ces options sont l’ensemble des fonctionnalités que la carte peut avoir. Parmi ces options à afficher, nous avons les éléments suivants :

• Nom: C’est le nom qui sera affiché sur la carte, basé sur les coordonnées qui sont ajoutées dans l’emplacement.
• ModeNavigation : C’est le type de navigation avec lequel la carte sera ouverte. Dans les modes de navigation, nous avons les éléments suivants :

🚴	Aller à vélo
🚗	Conduite
🛣️	Transit
🚶	Marche

Nous aurons un résultat comme celui-ci :

var options = new MapLaunchOptions { Name = "Statue of Liberty Museum",
NavigationMode= NavigationMode.Driving };

OpenAsync

Enfin, ouvrons la Map avec la méthode OpenAsync.

public async Task OpenMap()
{
    var location = new Location(47.645160, -122.1306032);
    var options = new MapLaunchOptions { Name = "Microsoft Building 25" };
    await Map.Default.OpenAsync(location, options);
}

Assurez-vous de vérifier si la carte est ouverte

N’oubliez pas que l’ouverture de la carte peut échouer, soit parce qu’aucune application n’est installée, soit parce qu’elle ne dispose pas des autorisations nécessaires. C’est pourquoi il est conseillé de toujours vérifier si la carte s’est ouverte ou non.

Ceci est réalisé avec le EssayerOpenAsync méthode. Elle a les mêmes surcharges que la méthode OpenAsync et renvoie un Bool en réponse.

if (await Map.Default.TryOpenAsync(location, options) == true)
{
    // Write the code for when it opens your map.
}

Limites de la plate-forme

Le ModeNavigation seront présentés dans votre candidature si la plateforme le permet. Ci-dessous, je vous montre le support pour chacun d’eux:

Android

• Vélo, conduite et marche.

iOS/macOS

• Conduite, transport en commun et marche.

les fenêtres

• Conduite, transport en commun et marche.

Emballer

Et.. Voila! 💪 Vous êtes prêt à commencer à implémenter Maps dans votre .NET FIXE applications!! 💚💕

À la prochaine! 🙋‍♀️

Référence: