Na tej stronie znajdziesz podstawowe, wymagane czynności, które należy wykonać, aby zacząć korzystać z dowolnego interfejsu API lub pakietu SDK w Google Maps Platform.
Krótkie wprowadzenie
Jeśli nigdy nie zdarzyło Ci się utworzyć konta rozliczeniowego ani projektu w konsoli Google Cloud, kliknij przycisk Rozpocznij, który prowadzi do interaktywnej konfiguracji w konsoli Cloud dla nowych użytkowników:
RozpocznijMożesz też wykonać te wymagane czynności konfiguracyjne:
Krok 1. Skonfiguruj projekt
Konsola
-
W konsoli Google Cloud na stronie selektora projektów kliknij Utwórz projekt, aby rozpocząć tworzenie nowego projektu Cloud.
-
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 kończy się 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 każdej chwili. Więcej informacji znajdziesz w artykułach o środkach na koncie rozliczeniowym i rozliczeniach.
Pakiet SDK Cloud
gcloud projects create "PROJECT"
Więcej informacji o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i tych poleceniach:
Krok 2. Włącz interfejsy API lub pakiety SDK
Aby korzystać z Google Maps Platform, musisz włączyć interfejsy API lub pakiety SDK, których chcesz używać 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 Eksploratora możliwości lub zapoznaj się z dokumentacją interfejsu API lub pakietu SDK, którego chcesz użyć.
Aby włączyć co najmniej 1 interfejs API lub pakiet SDK:
Konsola
-
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:
- 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 na przycisku widnieje napis 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. (Kliknij przycisk WYŁĄCZ, aby usunąć interfejs API lub pakiet SDK z tego projektu).
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 o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud 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" \ "weather.googleapis.com"
Krok 3. Uzyskaj klucz interfejsu API
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 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ć nowy klucz lub dodać interfejs API bądź pakiet SDK do istniejącego klucza, wykonaj te instrukcje.
Konsola
-
Otwórz stronę Google Maps Platform > Klucze i dane logowania.
- Jeśli pojawi się taka prośba, wybierz projekt.
-
Wykonaj jedną z tych czynności:
-
Utwórz nowy klucz:
- Kliknij Utwórz dane logowania > Klucz interfejsu API.
- W panelu Utwórz klucz interfejsu API otwórz listę Wybierz ograniczenia interfejsu API.
- Odznacz wszystkie interfejsy API, których ten klucz nie potrzebuje, i upewnij się, że interfejsy API, których planujesz używać, pozostaną zaznaczone.
- Kliknij Utwórz. W panelu pojawi się nowy klucz interfejsu API.
-
Użyj istniejącego klucza:
- Kliknij nazwę klucza.
- Na liście Wybierz ograniczenia interfejsu API wybierz interfejsy API, których chcesz używać.
- Kliknij Zapisz.
Wybranie interfejsu API w tym miejscu nie powoduje jego włączenia. Upewnij się, że każdy wybrany interfejs API jest włączony w bibliotece interfejsów API.
-
- Aby później wyświetlić ciąg klucza, otwórz stronę Klucze i dane uwierzytelniające i kliknij Pokaż klucz.
Jeśli konsola wygląda inaczej niż w tych krokach, zapoznaj się z artykułami Tworzenie klucza interfejsu API i Dodawanie ograniczeń interfejsu API w dokumentacji Google Cloud.
Pakiet SDK Cloud
W poniższych poleceniach zastąp PROJECT_ID identyfikatorem swojego projektu.
-
Utwórz nowy klucz: uruchom to polecenie i zastąp DISPLAY_NAME nazwą klucza. Zastąp SERVICE_NAME nazwą usługi interfejsu API, którego chcesz używać, np.
places.googleapis.com. Aby zezwolić na więcej interfejsów API, powtórz flagę--api-target.gcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=SERVICE_NAME
Więcej informacji o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i tych poleceniach:
-
Użyj istniejącego klucza: uruchom to polecenie i zastąp KEY_ID identyfikatorem klucza. Zastąp SERVICE_NAME nazwą usługi interfejsu API, który chcesz dodać. Flaga
--appendzachowuje interfejsy API, które klucz już dopuszcza. Bez niego polecenie zastępuje je.gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=SERVICE_NAME
Więcej informacji o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i tych poleceniach:
Identyfikator klucza nie jest ciągiem klucza ani wyświetlaną nazwą. Aby go znaleźć, uruchom
gcloud services api-keys list --project="PROJECT_ID". Identyfikator to ostatnia część polaname:projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.
Aby zobaczyć ciąg klucza, uruchom gcloud services api-keys get-key-string KEY_ID
--project="PROJECT_ID".
Środki na koncie rozliczeniowym
- Jeśli nie jesteś płacącym klientem Google Cloud, Google Maps Platform ani Firebase i nie masz jeszcze konta bezpłatnej wersji próbnej Google Cloud, możesz skorzystać z bezpłatnej wersji próbnej i środków na powitanie w wysokości 300 USD, które możesz wydać na usługi Google Maps Platform.
- Każdy kod SKU Google Maps Platform zapewnia określoną ilość bezpłatnego wykorzystania w ciągu miesiąca, która jest podana w cenniku i opisana w informacjach o rozliczeniach w Google Maps Platform.
- Google udostępnia też środki na programy publiczne, takie jak organizacje non-profit, startupy, centra kryzysowe, media informacyjne, edukacja i przewoźnicy.
Dalsze kroki
Po skonfigurowaniu możesz zacząć korzystać z interfejsów API i pakietów SDK Google Maps Platform. Więcej informacji znajdziesz w przeglądzie, przewodniku dla deweloperów i przewodniku dla początkujących dotyczącym 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).