Een iOS-app maken (preview)

  • Artikel

In dit artikel leest u 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.

Notitie

Buitengebruikstelling van Azure Kaarten iOS SDK

De Azure Kaarten Native SDK voor iOS is nu afgeschaft en wordt buiten gebruik gesteld op 3-31-25. Om serviceonderbrekingen te voorkomen, migreert u tegen 3-31-25 naar de Azure Kaarten Web SDK. Zie de migratiehandleiding voor de Azure Kaarten iOS SDK voor meer informatie.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Notitie

Zie Verificatie beheren in Azure Maps voor meer informatie over verificatie in Azure Maps.

Een Azure Maps-account maken

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

  1. Selecteer in de linkerbovenhoek van 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 Maken.

    Maak een Azure Maps-account.

De abonnementssleutel 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.

Notitie

In deze quickstart wordt gebruikgemaakt van gedeelde sleutelverificatie voor demonstratiedoeleinden, maar de voorkeursbenadering voor elke productieomgeving is het gebruik van Microsoft Entra-verificatie.

Schermopname van uw Azure Kaarten-abonnementssleutel in Azure Portal.

Een project maken in Xcode

Maak eerst een nieuw iOS App-project. Voer deze stappen uit 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 in, bundel-id en selecteer vervolgens Volgende.

Zie het artikel Een Xcode-project maken voor een app voor meer hulp bij het maken van een nieuw project.

Maak de eerste iOS-toepassing.

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 met het gewenste Xcode iOS-project dat is geselecteerd in projectnavigator de + knop om pakketafhankelijkheid toe te voegen.

    Voeg pakketafhankelijkheid toe.

  2. Voer de volgende waarden 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.3 het veld Versie van de afhankelijkheidsregel in.

    Voeg afhankelijkheidsregel toe aan een iOS-project.

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

    Voeg een pakket toe aan een iOS-project.

MapControl-weergave toevoegen

  1. Aangepast toevoegen UIView om controller weer te geven

  2. Klasse selecteren MapControl in AzureMapsControl module

    Een Azure Maps-besturingselement toevoegen.

  3. In het bestand AppDelegate.swift :

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

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

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

    Voer de iOS-toepassing uit.

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

Uw eerste kaart in een iOS-toepassing.

Toegang tot kaartfunctionaliteit

U kunt de kaartfunctionaliteit aanpassen door een instantie in een mapView.onReady handler vast te AzureMap houden. Zodra de MapControl weergave is toegevoegd, ziet uw voorbeeld ViewController er ongeveer als volgt uit:

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        let mapView = self.view.subviews.first as? MapControl;
        mapView?.onReady({ map in
            // customize your map here
            // map.sources.add()
            // map.layers.insertLayer()
        })
    }
}

Ga verder met het toevoegen van een veelhoeklaag aan de kaart in de iOS SDK voor een dergelijk voorbeeld.

Resources opschonen

Voer deze stappen uit 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 verder te 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 iOS-apps te blijven ontwikkelen, moet u Xcode verwijderen.

Aanvullende informatie

Zie de volgende artikelen voor meer codevoorbeelden: