Een iOS-app maken (preview)

In dit artikel wordt beschreven hoe u de Azure-Kaarten toevoegt aan een iOS-app. U wordt door de volgende basisstappen geleid:

• De ontwikkelomgeving instellen.
• Uw eigen Azure Maps-account maken.
• De primaire Azure Maps-sleutel voor gebruik in de app ophalen.
• De Azure Maps-bibliotheken vanuit het project raadplegen.
• Een Azure Maps-besturingselement aan de app toevoegen.

Vereisten

• Maak een Azure Kaarten-account door u aan te melden bij de Azure Portal. Als u nog geen abonnement op Azure hebt, maakt u een gratis account voordat u begint.
• Een Azure Maps-account maken
• Verkrijg een primaire abonnementssleutel, ook wel de primaire sleutel of de abonnementssleutel genoemd. Zie Verificatie beheren in Azure Kaarten voor meer informatie over verificatie in Azure Kaarten.
• Download Xcode gratis op de Mac App Store.

Een Azure Maps-account maken

Voer de volgende stappen uit om een nieuw Azure Maps-account te maken:

1. Selecteer in de linkerbovenhoek van de Azure Portal de optie Een resource maken.

2. Typ Azure Maps in het vak Marketplace doorzoeken.

3. Selecteer in de resultaten Azure Kaarten en selecteer vervolgens de knop Maken die onder de kaart wordt weergegeven.

4. Voer de volgende waarden in op de pagina Azure Kaarten-account maken:

   • Het Abonnement dat u wilt gebruiken voor dit account.
   • De naam van de Resourcegroep voor dit account. U kunt kiezen om een Nieuwe of Bestaande resourcegroep te gebruiken.
   • De Naam van uw nieuwe account.
   • De Prijscategorie voor dit account.
   • Lees de licentie en de privacyverklaring, en schakel het selectievakje in om de voorwaarden te accepteren.
   • Selecteer de knop Create (Maken).

   

De primaire sleutel voor uw account ophalen

Als het Azure Kaarten-account is gemaakt, haalt u de primaire sleutel op waarmee u query's kunt uitvoeren op de API's van kaarten.

1. Open uw Maps-account in de portal.

2. Selecteer Verificatie in de sectie Instellingen.

3. Kopieer de Primaire Sleutel naar het Klembord. Sla de sleutel lokaal op voor gebruik verderop in deze zelfstudie.

Een project maken in Xcode

Maak eerst een nieuw iOS-app-project. Voltooi deze stappen om een Xcode-project te maken:

1. Selecteer onder Bestand de optie Nieuw -> Project.

2. Selecteer op het tabblad iOS de optie App en vervolgens Volgende.

3. Voer de naam van de app, de bundel-id in en selecteer Volgende.

Zie Creating a Xcode Project for an App (Een Xcode maken voor een app) voor meer informatie over het maken van een nieuw project.

De Azure Kaarten iOS SDK installeren

De volgende stap bij het bouwen van uw toepassing is het installeren van de Azure Kaarten iOS SDK. Volg deze stappen om de SDK te installeren:

1. Selecteer het gewenste Xcode iOS-project in Project navigator en selecteer de knop + Pakketafhankelijkheid toevoegen.

   

2. Voer het volgende in het resulterende dialoogvenster in:

   • Voer https://github.com/Azure/azure-maps-ios-sdk-distribution.git in de zoekbalk in die in de rechterbovenhoek wordt weergegeven.
   • Selecteer Up to Next Major Version in het veld Afhankelijkheidsregel.
   • Voer 1.0.0-pre.1 in het veld Versie van afhankelijkheidsregel in.

   

3. Zodra het pakket naast de afhankelijkheden is opgelost, selecteert u de knop Pakket toevoegen om de installatie van de afhankelijkheid te voltooien.

   

MapControl-weergave toevoegen

1. Aangepast toevoegen om UIView controller weer te geven

2. Klasse MapControl selecteren in AzureMapsControl module

   

3. In het bestand AppDelegate.swift moet u het volgende doen:

   • import toevoegen voor de Azure Kaarten-SDK
   • de Azure Maps-verificatiegegevens instellen

Door de verificatiegegevens voor de AzureMaps-klasse globaal in te stellen met behulp van de methoden of, hoeft u uw verificatiegegevens niet in elke weergave AzureMaps.configure(subscriptionKey:) AzureMaps.configure(aadClient:aadAppId:aadTenant:) toe te voegen.

1. Selecteer de knop Uitvoeren, zoals wordt weergegeven in de volgende afbeelding (of druk op CMD + R ) om uw toepassing te bouwen.

   

Het duurt enkele seconden voordat Xcode de toepassing heeft gebouwd. Nadat de build is voltooid, kunt u uw toepassing testen op het gesimuleerde iOS-apparaat. U krijgt een kaart te zien zoals deze:

Resources opschonen

Neem deze stappen om de resources op te schonen die in deze quickstart zijn gemaakt:

1. Sluit Xcode en verwijder het project dat u hebt gemaakt.

2. Als u de toepassing op een extern apparaat hebt getest, verwijdert u de toepassing van dat apparaat.

Als u niet van plan bent om door te gaan met ontwikkelen met de Azure Kaarten iOS SDK:

1. Navigeer naar de Azure-portalpagina. Selecteer Alle resources op de hoofdpagina van de portal. Of selecteer het menupictogram in de linkerbovenhoek en vervolgens Alle resources.

2. Selecteer uw Azure Kaarten account. Selecteer Verwijderen bovenaan de pagina.

3. Als u niet van plan bent om door te gaan met het ontwikkelen van iOS-apps, kunt u Xcode eventueel verwijderen.

Aanvullende informatie

Zie de volgende artikelen voor aanvullende codevoorbeelden:

• Verificatie in Azure Maps beheren
• Kaartstijlen wijzigen in iOS-kaarten
• Een symboollaag toevoegen
• Een lijnlaag toevoegen
• Een polygoonlaag toevoegen