Krótkie wprowadzenie do Maps Embed API

Umieść na stronie internetowej interaktywną mapę lub panoramę Street View za pomocą prostego żądania HTTP – bez użycia niestandardowego JavaScriptu.

Koszty

Wszystkie żądania wysyłane do interfejsu Maps Embed API są bezpłatne i można z nich korzystać bez ograniczeń. Wszystkie żądania nadal wymagają jednak prawidłowego klucza interfejsu Google Cloud API. Więcej informacji znajdziesz w artykule Korzystanie i rozliczenia.

Zanim zaczniesz

Aby utworzyć mapę umieszczoną na stronie internetowej, wykonaj wymagane czynności konfiguracyjne, klikając te karty:

Krok 1

Konsola

  1. W konsoli Google Cloud na stronie wyboru projektu kliknij Utwórz projekt , aby rozpocząć tworzenie nowego projektu Cloud.

    Otwórz stronę wyboru projektu

  2. Sprawdź, czy w projekcie w chmurze włączone są płatności. Upewnij się, że w projekcie włączone są płatności.

    Google Cloud oferuje bezpłatny okres próbny. Okres próbny wygasa po 90 dniach lub po naliczeniu na koncie opłat w wysokości 300 USD – w zależności od tego, co nastąpi wcześniej. Możesz zrezygnować w dowolnym momencie. Więcej informacji znajdziesz w artykułach Środki na koncie rozliczeniowym i Rozliczenia.

Pakiet SDK Cloud

gcloud projects create "PROJECT"

Więcej informacji o pakiecie SDK Google Cloud , instalacji pakietu SDK Cloud i tych poleceniach:

Krok 2

Aby korzystać z Google Maps Platform, musisz włączyć interfejsy API lub pakiety SDK, których zamierzasz używać w projekcie.

Konsola

Włącz interfejs Maps Embed API.

Pakiet SDK Cloud

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

Więcej informacji o pakiecie SDK Google Cloud , instalacji pakietu SDK Cloud i tych poleceniach:

Krok 3

Ten krok dotyczy tylko procesu tworzenia klucza interfejsu API. Jeśli używasz klucza interfejsu API w środowisku produkcyjnym, zdecydowanie zalecamy jego ograniczenie. Więcej informacji znajdziesz na stronie Używanie kluczy interfejsu API dotyczącej konkretnej usługi.

Klucz interfejsu API to unikalny identyfikator używany do uwierzytelniania żądań powiązanych z projektem na potrzeby wykorzystania i płatności. Z projektem musi być powiązany co najmniej 1 klucz interfejsu API.

Aby utworzyć klucz interfejsu API:

Konsola

  1. Otwórz stronę Google Maps Platform > Dane logowania.

    Otwórz stronę Dane logowania

  2. Na stronie Dane logowania kliknij Utwórz dane logowania > Klucz interfejsu API.
    W oknie Utworzono klucz API pojawi się nowo utworzony klucz.
  3. Kliknij Zamknij.
    Nowy klucz interfejsu API pojawi się na stronie Dane logowania w sekcji Klucze API.
    (Pamiętaj, aby ograniczyć klucz interfejsu API przed użyciem go w środowisku produkcyjnym).

Pakiet SDK Cloud

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Więcej informacji o pakiecie SDK Google Cloud , instalacji pakietu SDK Cloud i tych poleceniach:

Generowanie elementu iframe

Kliknij te opcje i dodaj lokalizację oraz klucz interfejsu API, aby wygenerować element iframe na potrzeby strony internetowej. Dodatkowe parametry i opcje znajdziesz w artykule Umieszczanie mapy.

Testowanie elementu iframe

Aby zobaczyć element iframe w oknie przeglądarki HTML:

  1. Otwórz domyślny edytor tekstu. Na urządzeniu powinny być domyślnie zainstalowane edytory tekstu, takie jak TextEdit czy Notatnik w systemie Microsoft Windows.
  2. Utwórz plik HTML i nadaj mu nazwę index.html.

  3. Dodaj ten kod z wygenerowanym powyżej elementem iframe:

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. Zapisz plik HTML index.html.

  5. Otwórz plik HTML w przeglądarce internetowej, przeciągając go z pulpitu do przeglądarki. W większości systemów operacyjnych możesz też kliknąć plik dwukrotnie.

Gratulacje! Udało Ci się skonfigurować i utworzyć mapę za pomocą interfejsu Maps Embed API.

Czyszczenie danych

Możesz usunąć projekt Google Cloud, co spowoduje zaprzestanie naliczania opłat za wszelkie zasoby wykorzystywane w ramach tego projektu.

  1. W konsoli Google Cloud otwórz stronę Zarządzanie zasobami:

    Otwórz stronę Zarządzanie zasobami

  2. Jeśli projekt, który chcesz usunąć, jest powiązany z organizacją, wybierz i rozwiń listę organizacji u góry strony.
  3. Z listy projektów wybierz projekt do usunięcia i kliknij Usuń.
  4. W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.

Dalsze kroki