Szybki start: tworzenie interaktywnej mapy wyszukiwania za pomocą usługi Azure Maps

W tym przewodniku Szybki start pokazano, jak za pomocą usługi Azure Maps utworzyć mapę, która zapewnia użytkownikom interaktywne środowisko wyszukiwania. Przeprowadza on użytkownika przez następujące podstawowe kroki:

• Tworzenie konta usługi Azure Maps.
• Pobierz klucz subskrypcji usługi Azure Maps do użycia w demonstracyjnej aplikacji internetowej.
• Pobierz i otwórz aplikację mapy demonstracyjnej.

Wymagania wstępne

• Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

• Zaloguj się w witrynie Azure Portal.

Tworzenie konta usługi Azure Maps

Utwórz nowe konto usługi Azure Maps, wykonując następujące czynności:

1. Wybierz pozycję Utwórz zasób w lewym górnym rogu witryny Azure Portal.

2. Wpisz Azure Maps w polu usługa wyszukiwania s i Marketplace.

3. Wybierz pozycję Azure Maps z wyświetlonej listy rozwijanej, a następnie wybierz przycisk Utwórz .

4. Na stronie Tworzenie zasobu konta usługi Azure Maps wprowadź następujące wartości, a następnie wybierz przycisk Utwórz:

   • Subskrypcja, która ma być używana dla tego konta.
   • Nazwa grupy zasobów dla tego konta. Możesz wybrać opcję Utwórz nową lub Wybierz istniejącą grupę zasobów.
   • Nazwa nowego konta usługi Azure Maps.
   • Warstwa cenowa dla tego konta. Wybierz pozycję Gen2.
   • Przeczytaj oświadczenie o licencji i ochronie prywatności, a następnie zaznacz pole wyboru, aby zaakceptować warunki.

   

Pobieranie klucza subskrypcji dla konta

Po pomyślnym utworzeniu konta usługi Azure Maps pobierz klucz subskrypcji, który umożliwia wykonywanie zapytań względem interfejsów API usługi Maps.

1. Otwórz konto usługi Maps w portalu.
2. W sekcji ustawień wybierz pozycję Uwierzytelnianie.
3. Skopiuj klucz podstawowy i zapisz go lokalnie, aby użyć go w dalszej części tego samouczka.

Uwaga

W tym przewodniku Szybki start użyto metody uwierzytelniania klucza współużytkowanego do celów demonstracyjnych, ale preferowaną metodą dla dowolnego środowiska produkcyjnego jest użycie uwierzytelniania identyfikatora Entra firmy Microsoft.

Pobieranie i aktualizowanie pokazu usługi Azure Maps

1. Skopiuj zawartość pliku: Interakcyjne wyszukiwanie Quickstart.html.
2. Zapisz lokalnie zawartość tego pliku jako AzureMapDemo.html. Otwórz ten plik w edytorze tekstów.
3. Dodaj wartość Klucz podstawowy uzyskaną w poprzedniej sekcji
   1. Oznacz jako komentarz cały kod w authOptions funkcji . Ten kod jest używany do uwierzytelniania w usłudze Microsoft Entra.
   2. Usuń komentarz z dwóch ostatnich wierszy w funkcji. Ten kod jest używany do uwierzytelniania klucza współużytkowanego, czyli podejścia używanego w tym przewodniku authOptions Szybki start.
   3. Zastąp <Your Azure Maps Key> ciąg wartością klucza subskrypcji z poprzedniej sekcji.

Otwieranie aplikacji demonstracyjnej

1. Otwórz plik AzureMapDemo.html w wybranej przeglądarce.

2. Spójrz na mapę miasta Los Angeles. Powiększ i pomniejsz, aby zobaczyć, jak mapa jest automatycznie renderowana z większą lub mniejszą ilością informacji w zależności od poziomu powiększenia.

3. Zmień domyślny środek mapy. W pliku AzureMapDemo.html wyszukaj zmienną o nazwie center. Zastąp parę wartości długości i szerokości geograficznej tej zmiennej nowymi wartościami [-74.0060, 40.7128]. Zapisz plik i odśwież przeglądarkę.

4. Wypróbuj funkcję wyszukiwania interaktywnego. W polu wyszukiwania w lewym górnym rogu demonstracyjnej aplikacji internetowej wyszukaj restauracje.

5. Przesuń wskaźnik myszy na liście adresów i lokalizacji, które są wyświetlane pod polem wyszukiwania. Zwróć uwagę, jak za pomocą odpowiedniej pinezki na mapie wyświetlane są informacje o tej lokalizacji. Ze względu na ochronę danych prywatnych firm wyświetlono fikcyjne nazwy i adresy.

   

Czyszczenie zasobów

Ważne

Samouczki wymienione w sekcji Następne kroki szczegółowo opisują sposób używania i konfigurowania usługi Azure Maps przy użyciu konta. Jeśli planujesz kontynuować pracę z samouczkami, nie usuwaj zasobów utworzonych w tym przewodniku Szybki start.

Jeśli nie planujesz kontynuować pracy z samouczkami, wykonaj następujące kroki, aby wyczyścić zasoby:

1. Zamknij przeglądarkę z uruchomioną aplikacją internetową AzureMapDemo.html.
2. Przejdź do Portalu Azure. Wybierz pozycję Wszystkie zasoby na stronie portalu głównego lub wybierz ikonę menu w lewym górnym rogu, a następnie pozycję Wszystkie zasoby.
3. Wybierz konto usługi Azure Maps, a następnie wybierz pozycję Usuń w górnej części strony.

Aby uzyskać więcej przykładów kodu i interaktywnego środowiska kodowania, zobacz następujące artykuły:

• Znajdowanie adresu za pomocą usługi wyszukiwania w usłudze Azure Maps
• How to use Azure Maps map control (Jak używać kontrolki mapy usługi Azure Maps)

Następne kroki

W tym przewodniku Szybki start utworzono konto usługi Azure Maps i aplikację demonstracyjną. Zapoznaj się z następującymi samouczkami, aby dowiedzieć się więcej o usłudze Azure Maps:

Wyszukiwanie pobliskich punktów orientacyjnych za pomocą usługi Azure Maps