Uzyskiwanie klucza interfejsu API

Wybierz platformę: Android iOS JavaScript

Po skonfigurowaniu rozliczeń i projektu, włączeniu pakietu SDK oraz zainstalowaniu preferowanego menedżera zależności i innego oprogramowania możesz utworzyć, dodać i ograniczyć swój klucz interfejsu API.

Tworzę klucze interfejsu API

Klucz interfejsu API to unikalny identyfikator, który uwierzytelnia żądania powiązane z Twoim projektem na potrzeby użytkowania 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 znajdziesz na stronie Dane logowania w sekcji Klucze interfejsu API.
    (Pamiętaj, aby ograniczyć klucz interfejsu API, zanim użyjesz go w środowisku produkcyjnym.

(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:

Ten klucz interfejsu API będzie potrzebny podczas tworzenia projektu Xcode zgodnie z opisem w artykule Konfigurowanie projektu Xcode.

Ograniczanie kluczy interfejsu API

Zdecydowanie zalecamy ograniczenie ich użycia do tych interfejsów API, które są niezbędne dla danej aplikacji. Ograniczenie kluczy interfejsu API zwiększa bezpieczeństwo aplikacji przez ochronę jej przed nieuzasadnionymi żądaniami. Więcej informacji znajdziesz w artykule Sprawdzone metody zabezpieczania interfejsów API.

Aby ograniczyć klucz interfejsu API:

Konsola

  1. Otwórz stronę Google Maps Platform > Dane logowania.

    Otwórz stronę Dane logowania

  2. Wybierz klucz interfejsu API, dla którego chcesz zastosować ograniczenie. Pojawi się strona właściwości klucza interfejsu API.
  3. W sekcji Ograniczenia kluczy ustaw te ograniczenia:
    • Ograniczenia aplikacji:
      1. Wybierz Aplikacje na iOS.
      2. Aby akceptować żądania z aplikacji na iOS o podanym przez Ciebie identyfikatorze pakietu, wybierz z listy odpowiedni identyfikator pakietu na iOS.
    • Ograniczenia interfejsów API:
      1. Kliknij Ogranicz klucz.
      2. Wybierz Maps SDK na iOS z menu Wybierz interfejsy API. Jeśli pakietu SDK Maps na iOS nie ma na liście, musisz go enable.
  4. Aby zastosować zmiany, kliknij Zapisz.

(pakiet) SDK Cloud

Wyświetl listę istniejących kluczy. 

gcloud services api-keys list --project="PROJECT"

Usuń ograniczenia dotyczące istniejącego klucza. 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Ustaw nowe ograniczenia dla istniejącego klucza. 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-ios-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

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

Masz już klucz interfejsu API do pakietu SDK Map Google na iOS, więc możesz rozpocząć.

Co dalej

Po uzyskaniu klucza interfejsu API utwórz i skonfiguruj projekt Xcode zgodnie z opisem w sekcji Konfigurowanie projektu Xcode.