Pierwsze kroki z Google Maps Platform

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

Krótkie wprowadzenie

Jeśli nigdy nie używasz konsoli Google Cloud do tworzenia 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 te 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 włączone są płatności.

    Google Cloud oferuje okres próbny za 0,00 PLN. Okres próbny wygasa po 90 dniach lub po naliczeniu na koncie opłat o wartości 300 USD, w zależności od tego, co nastąpi wcześniej. Anuluj w dowolnym momencie. Więcej informacji znajdziesz w artykułach Środki na koncie rozliczeniowym i Rozliczenia i płatności.

Pakiet SDK Cloud

gcloud projects create "PROJECT"

Więcej informacji znajdziesz w artykułach Google Cloud SDK, Instalacja pakietu Cloud SDK oraz w opisach tych poleceń:

Krok 2

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

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

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

Konsola

  1. Aby zobaczyć interfejsy API i pakiety SDK Google Maps Platform, które możesz włączyć, otwórz stronę Biblioteka interfejsów API Map Google w konsoli Cloud:

    Otwórz stronę Biblioteka interfejsów API Map Google.

  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, interfejs API lub pakiet SDK jest już włączony i nie musisz nic robić.
    • Kliknięcie dowolnego przycisku 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 Map, Tras i Miejsc:

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"

Więcej informacji znajdziesz w artykułach Google Cloud SDK, Instalacja pakietu Cloud SDK oraz w opisach tych poleceń:

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

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.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 jego ograniczenie. Więcej informacji znajdziesz na stronie Korzystanie z 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 interfejsu 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 znajdziesz w artykułach Google Cloud SDK, Instalacja pakietu Cloud SDK oraz w opisach tych poleceń:

Środki na koncie rozliczeniowym

Gdy utworzysz konto rozliczeniowe i projekt, możesz skorzystać z bezpłatnego okresu próbnego Google Cloud o wartości 300 USD. Każdy kod SKU Google Maps Platform zapewnia określoną ilość bezpłatnego wykorzystania w ciągu miesiąca, co jest widoczne na liście cen i opisane w sekcji Rozliczenia Google Maps Platform. Google przyznaje też środki na programy publiczne, takie jak organizacje non-profit, startupy, reagowanie kryzysowe, media informacyjne, edukacja i agencje transportu publicznego.

Dalsze kroki

Po skonfigurowaniu możesz zacząć korzystać z interfejsów API i pakietów SDK Google Maps Platform. Więcej informacji znajdziesz w przewodnikach Omówienie, Dla programistów i Wprowadzenie do interfejsu API lub pakietu SDK, który Cię interesuje. Interfejsy API i pakiety SDK są wymienione w  dokumentacji Google Maps Platform (według usługi) i interfejsach API Google Maps Platform (według platformy).