Pierwsze kroki z Google Maps Platform

Na tej stronie znajdziesz podstawowe czynności, które musisz wykonać, aby zacząć korzystać z interfejsów API i pakietów SDK w Google Maps Platform.

Krótkie wprowadzenie

Jeśli nigdy nie korzystałeś(-aś) z konsoli Google Cloud do utworzenia konta rozliczeniowego ani projektu, kliknij przycisk Rozpocznij, który prowadzi do interaktywnej konfiguracji w konsoli Cloud dla nowych użytkowników:

Rozpocznij

Możesz też wykonać wymagane czynności konfiguracyjne, klikając kolejno te 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 Twoim projekcie są włączone płatności.

    Google Cloud oferuje bezpłatny okres próbny. Okres próbny wygasa po 90 dniach lub po osiągnięciu przez konto kwoty 300 USD, zależnie od tego, co nastąpi wcześniej. Możesz anulować subskrypcję w każdej chwili. Google Maps Platform oferuje stałe 200 USD miesięcznie. Więcej informacji znajdziesz w artykułach Środki na koncie rozliczeniowym i Rozliczenia.

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 korzystać z Google Maps Platform, musisz włączyć interfejsy API lub pakiety SDK, których chcesz użyć w projekcie.

Pamiętaj, że niektóre integracje wymagają włączenia wielu interfejsów API lub pakietów SDK. Jeśli nie wiesz, które interfejsy API lub pakiety SDK włączyć, użyj selektora interfejsów API lub zapoznaj się z dokumentacją interfejsu API/pakietu SDK, którego chcesz użyć.

Aby włączyć co najmniej 1 interfejs API lub pakiet SDK:

Konsola

  1. Zapoznaj się z interfejsami API i pakietami SDK Google Maps Platform, które możesz włączyć na stronie Biblioteka interfejsu API Mapy w konsoli Cloud:

    Otwórz stronę Biblioteki interfejsu API Map.

  2. Kliknij interfejs API lub pakiet SDK, który chcesz włączyć.
    • Jeśli na przycisku jest napis WŁĄCZ, kliknij go, aby włączyć interfejs API lub pakiet SDK.
    • Jeśli przycisk ma etykietę ZARZĄDZAJ, oznacza to, że interfejs API lub pakiet SDK jest już włączony i nie musisz nic więcej robić.
    • Kliknięcie dowolnego z nich spowoduje wyświetlenie panelu interfejsu API lub pakietu SDK. (aby usunąć interfejs API lub pakiet SDK z tego projektu, kliknij przycisk WYŁĄCZ).

Pakiet SDK Cloud

To polecenie włącza wszystkie interfejsy API Mapy, Trasy i Miejsca:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

Aby włączyć interfejsy API środowiska, użyj tego polecenia:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com"

Krok 3

Ten krok obejmuje tylko proces 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 Korzystanie z kluczy interfejsu API dotyczącej danej 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ć klucz API przed użyciem go w produkcji).

Pakiet SDK Cloud

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

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

Środki na koncie rozliczeniowym

Po utworzeniu konta rozliczeniowego i projektu możesz skorzystać z bezpłatnego okresu próbnego Google Cloud, w którym masz do dyspozycji środki w wysokości 300 USD. Każdy kod SKU Google Maps Platform zapewnia określoną ilość bezpłatnego miesięcznego wykorzystania, która jest podana w cenniku i opisywana w naliczaniu opłat za Google Maps Platform. Google przyznaje też środki na programy publiczne, takie jak organizacje non-profit, startupy, organizacje zajmujące się kryzysem, media, instytucje edukacyjne i organizacje transportowe.

Dalsze kroki

Po zakończeniu konfiguracji możesz zacząć korzystać z interfejsów API i pakietów SDK Google Maps Platform. Więcej informacji znajdziesz w przewodniku Omówienie, Przewodnik dla programistów i Przewodnik wdrożeniowy dotyczący interesującego Cię interfejsu API lub pakietu SDK. Interfejsy API i pakiety SDK znajdziesz w  dokumentacji Google Maps Platform (według usługi) oraz interfejsach API Google Maps Platform (według platformy).