Krótkie wprowadzenie do Maps Embed API

Umieść na swojej stronie internetowej interaktywną mapę lub panoramę Street View za pomocą prostego żądania HTTP, które nie wymaga obsługi języka JavaScript.

Koszty

Wszystkie żądania do interfejsu Maps Embed API są dostępne bezpłatnie i bez ograniczeń. Wszystkie żądania nadal wymagają jednak prawidłowego klucza interfejsu Google Cloud API. Więcej informacji znajdziesz w artykule Korzystanie i płatności.

Zanim zaczniesz

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

Krok 1

Konsola

  1. W konsoli Google Cloud na stronie selektora projektów 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.

    Wersja próbna Google Cloud oferuje 0,00 USD. Okres próbny kończy się po 90 dniach lub po naliczeniu opłat w wysokości 300 USD, w zależności od tego, co nastąpi wcześniej. Anuluj, kiedy chcesz. Google Maps Platform oferuje cykliczną miesięczną kwotę promocyjną w wysokości 200 USD. Więcej informacji znajdziesz w sekcjach Środki na koncie rozliczeniowym i Płatności.

(pakiet) SDK Cloud

gcloud projects create "PROJECT"

Dowiedz się więcej o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i o następujących 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łączanie interfejsu Maps Embed API

(pakiet) SDK Cloud

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

Dowiedz się więcej o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i o następujących poleceniach:

Krok 3

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

Klucz interfejsu API to unikalny identyfikator, który uwierzytelnia żądania powiązane z Twoim projektem na potrzeby wykorzystania i rozliczeń. Musisz mieć co najmniej 1 klucz interfejsu API powiązany z projektem.

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 interfejsu API pojawi się nowo utworzony klucz interfejsu API.
  3. Kliknij Zamknij.
    Nowy klucz interfejsu API pojawi się na stronie Dane logowania w sekcji Klucze interfejsu API.
    Zanim użyjesz klucza interfejsu API w środowisku produkcyjnym, ogranicz jego użycie.

(pakiet) SDK Cloud

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

Dowiedz się więcej o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i o następujących poleceniach:

Generowanie elementu iframe

Kliknij poniższe opcje i dodaj lokalizację oraz klucz interfejsu API, aby wygenerować element iframe na swoją stronę internetową. 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. Domyślnie na urządzeniu powinny być zainstalowane edytory tekstu, takie jak TextEdit lub Notatnik Microsoft Windows.
  2. Utwórz plik HTML i nadaj mu nazwę index.html.
  3. Dodaj ten kod z wygenerowanym wcześniej elementem iframe:

    <html>
      <!-- Replace this code comment with your iframe. -->
    </html>
    
  4. Zapisz plik HTML index.html.

  5. Wczytaj plik HTML do przeglądarki, 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! Wystarczy skonfigurować i utworzyć mapę za pomocą interfejsu Maps Embed API.

Czyszczenie

Możesz usunąć swój projekt Google Cloud, aby przestać naliczać opłaty za wszystkie zasoby wykorzystywane 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 dołączony do organizacji, 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