Krótkie wprowadzenie do Maps Embed API

Umieść na swojej stronie interaktywną mapę lub panoramę Street View, korzystając z prostego żądania HTTP (bez JavaScriptu).

Koszty

Wszystkie żądania interfejsu Maps Embed API są dostępne bezpłatnie z nieograniczonym wykorzystaniem. Jednak do wszystkich żądań nadal wymagany jest prawidłowy klucz Google Cloud API. Więcej informacji znajdziesz w artykule Wykorzystanie i rozliczenia.

Zanim zaczniesz

Aby utworzyć osadzoną mapę na swojej stronie internetowej, wykonaj wymagane czynności konfiguracyjne, klikając poniższe karty:

Krok 1

Konsola

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

    Otwórz stronę selektora projektów

  2. Sprawdź, czy w projekcie Cloud włączone są płatności. Sprawdź, czy w projekcie są włączone płatności.

    Google Cloud oferuje bezpłatny okres próbny. Okres próbny wygasa po 90 dniach lub po przekroczeniu limitu 300 USD, zależnie od tego, co nastąpi wcześniej. Anuluj w dowolnym momencie. Google Maps Platform oferuje cykliczne środki w wysokości 200 USD miesięcznie. Więcej informacji znajdziesz w artykułach Środki na koncie rozliczeniowym i Płatności.

Pakiet SDK Cloud

gcloud projects create "PROJECT"

Dowiedz się więcej o pakiecie Google Cloud SDK, instalacji Cloud SDK i tych poleceniach:

Krok 2

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

Konsola

Włączanie interfejsu Maps Embed API

Pakiet SDK Cloud

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

Przeczytaj więcej o Google Cloud SDK, instalacji pakietu SDK Cloud i poniższych poleceniach:

Krok 3

Ten krok wykonuje się tylko w procesie tworzenia klucza interfejsu API. Jeśli używasz klucza interfejsu API w środowisku produkcyjnym, zdecydowanie zalecamy ograniczenie tego klucza. Więcej informacji znajdziesz na stronie Używanie kluczy interfejsu API w przypadku konkretnej usługi.

Klucz interfejsu API to unikalny identyfikator używany do uwierzytelniania żądań powiązanych z projektem na potrzeby wykorzystania i rozliczania. Z projektem musi być powiązany co najmniej 1 klucz 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 wyświetli się nowo utworzony klucz API.
  3. Kliknij Zamknij.
    Nowy klucz interfejsu API znajdziesz na stronie Dane logowania w sekcji Klucze API.
    (Pamiętaj, aby ograniczyć dostęp do klucza API przed użyciem go w produkcji).

Pakiet SDK Cloud

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

Przeczytaj więcej o Google Cloud SDK, instalacji pakietu SDK Cloud i poniższych poleceniach:

Generowanie elementu iframe

Klikaj kolejne opcje i dodaj lokalizację oraz klucz interfejsu API, aby wygenerować iframe dla swojej strony. Dodatkowe parametry i opcje znajdziesz w artykule Umieszczanie mapy.

Testowanie elementu iframe

Aby wyświetlić element iframe w oknie przeglądarki HTML:

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

  3. Dodaj ten kod do wygenerowanego wcześniej iframe:

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

  4. Zapisz plik HTML index.html.

  5. Plik HTML wczytuj w przeglądarce, przeciągając go z pulpitu do przeglądarki. W większości systemów operacyjnych dwukrotne kliknięcie pliku również działa.

Gratulacje! Właśnie skonfigurowałaś/skonfigurowałeś i utworzyłaś/utworzyłeś mapę za pomocą interfejsu Maps Embed API.

Czyszczę dane

Możesz usunąć projekt Google Cloud, aby zatrzymać naliczanie opłat za wszystkie zasoby używane w tym projekcie.

  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. Na liście 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

  • Aby zacząć tworzyć aplikacje z użyciem interfejsu Maps Embed API, skonfiguruj projekt Google Cloud:

    Skonfiguruj w Cloud Console

  • Lista dodatkowych parametrów i opcji, które możesz dodać do kodu iframe:

    Umieszczanie mapy

  • Rozszerz swój projekt Map za pomocą interfejsu JavaScript API:

    Maps JavaScript API