Quickstart: Een interactieve zoekkaart maken met Azure Kaarten

In deze quickstart ziet u hoe u Azure Kaarten gebruikt om een kaart te maken waarmee gebruikers een interactieve zoekervaring hebben. U wordt door de volgende basisstappen geleid:

  • Uw eigen Azure Maps-account maken.
  • Haal uw Azure Kaarten-abonnementssleutel op voor gebruik in de demo-webtoepassing.
  • De demo-kaarttoepassing downloaden en openen.

In deze quickstart wordt de Azure Kaarten Web SDK gebruikt, maar de Azure Kaarten-service kan worden gebruikt met elk kaartbesturingselement, zoals deze populaire opensource-kaartbesturingselementen waarvoor het Azure Kaarten-team invoegtoepassingen heeft gemaakt.

Vereisten

Een Azure Maps-account maken

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

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

  2. Typ Azure Kaarten in het vak Search-service s en Marketplace.

  3. Selecteer Azure Kaarten in de vervolgkeuzelijst die wordt weergegeven en selecteer vervolgens de knop Maken.

  4. Voer op de pagina Een Azure Kaarten-accountresource maken de volgende waarden in en selecteer vervolgens de knop Maken:

    • Het Abonnement dat u wilt gebruiken voor dit account.
    • De naam van de Resourcegroep voor dit account. U kunt ervoor kiezen om een nieuwe of bestaande resourcegroep te selecteren.
    • De naam van uw nieuwe Azure Kaarten-account.
    • De Prijscategorie voor dit account. Selecteer Gen2.
    • Lees de licentie- en privacyverklaring en schakel vervolgens het selectievakje in om de voorwaarden te accepteren.

    Screenshot showing the Create an Azure Maps Account resource page in the Azure portal.

De abonnementssleutel voor uw account ophalen

Zodra uw Azure Kaarten-account is gemaakt, haalt u de abonnementssleutel op waarmee u een query kunt uitvoeren op de Kaarten API's.

  1. Open uw Maps-account in de portal.
  2. Selecteer Verificatie in de sectie Instellingen.
  3. Kopieer de primaire sleutel en sla deze lokaal op om later in deze zelfstudie te gebruiken.

Screenshot showing your Azure Maps subscription key in the Azure portal.

Notitie

In deze quickstart wordt gebruikgemaakt van de verificatiemethode voor gedeelde sleutels voor demonstratiedoeleinden, maar de voorkeursbenadering voor elke productieomgeving is het gebruik van [Microsoft Entra ID]-verificatie.

De demo van Azure Kaarten downloaden en bijwerken

  1. Kopieer de inhoud van het bestand: Interactive Search Quickstart.html.
  2. Sla de inhoud van dit bestand lokaal op als AzureMapDemo.html. Open het in een teksteditor.
  3. Voeg de waarde van de primaire sleutel toe die u in de vorige sectie hebt gekregen
    1. Markeer alle code in de authOptions functie als commentaar. Deze code wordt gebruikt voor Microsoft Entra-verificatie.
    2. Verwijder opmerkingen bij de laatste twee regels in de authOptions functie. Deze code wordt gebruikt voor verificatie met gedeelde sleutels, de methode die in deze quickstart wordt gebruikt.
    3. Vervang <Your Azure Maps Key> door de waarde van de abonnementssleutel uit de vorige sectie.

De demo-toepassing openen

  1. Open het bestand AzureMapDemo.html in een browser naar keuze.

  2. Bekijk de kaart van Los Angeles. Zoom in en uit om te zien hoe de kaart automatisch met meer of minder informatie wordt weergegeven, afhankelijk van het zoomniveau.

  3. Wijzig de standaardinstelling voor het midden van de kaart. Zoek in het bestand AzureMapDemo.html naar de variabele center. Vervang de lengte- en breedtegraad voor deze variabele door deze nieuwe waarden: [-74.0060, 40.7128]. Sla het bestand op en vernieuw de browser.

  4. Probeer de interactieve zoekervaring uit. Zoek in het zoekvak linksboven in de demo-webtoepassing naar restaurants.

  5. Beweeg de muis over de lijst met adressen en locaties die worden weergegeven onder het zoekvak. U ziet hoe bij de bijbehorende speld op de kaart een pop-upvenster met informatie over die locatie wordt weergegeven. Ten behoeve van de privacy van particuliere bedrijven worden er fictieve namen en adressen weergegeven.

    Screenshot showing the interactive map search web application.

Resources opschonen

Belangrijk

In de zelfstudies in de sectie Volgende stappen vindt u gedetailleerde informatie over het gebruik en de configuratie van Azure Maps met uw account. Als u wilt doorgaan met de zelfstudies, verwijder de resources die u in deze quickstart hebt gemaakt dan niet.

Als u niet van plan bent om door te gaan naar de zelfstudies, voert u deze stappen uit voor het opschonen van de resources:

  1. Sluit de browser waarin de AzureMapDemo.html-webtoepassing wordt uitgevoerd.
  2. Ga naar Azure Portal. Selecteer Alle resources op de hoofdportalpagina of selecteer het menupictogram in de linkerbovenhoek en vervolgens Alle resources.
  3. Selecteer uw Azure Kaarten-account en selecteer vervolgens Verwijderen boven aan de pagina.

Zie de volgende artikelen voor meer codevoorbeelden en een interactieve coderingservaring:

Volgende stappen

In deze quickstart hebt u een Azure Kaarten-account en een demotoepassing gemaakt. Bekijk de volgende zelfstudies voor meer informatie over Azure Maps: