Uzyskiwanie klucza interfejsu API

Wybierz platformę: Android iOS JavaScript

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

Tworzenie kluczy interfejsu API

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

Ten klucz interfejsu API jest potrzebny podczas tworzenia projektu Xcode zgodnie z opisem w sekcji Konfigurowanie projektu Xcode.

Ograniczanie kluczy interfejsu API

Google zdecydowanie zaleca ograniczenie kluczy interfejsu API przez ograniczenie ich użycia tylko do tych interfejsów API, które są potrzebne w Twojej aplikacji. Ograniczenie kluczy interfejsu API zwiększa bezpieczeństwo aplikacji, chroniąc ją przed nieuzasadnionymi żądaniami. Ponosisz odpowiedzialność finansową za opłaty spowodowane nadużyciem kluczy interfejsu API bez ograniczeń. Więcej informacji znajdziesz w artykule Sprawdzone metody dotyczące bezpieczeństwa interfejsu 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 ustawić ograniczenie. Pojawi się strona właściwości klucza interfejsu API.
  3. W sekcji Ograniczenia klucza ustaw te ograniczenia:
    • Ograniczenia aplikacji:
      1. Wybierz Aplikacje na iOS.
      2. Aby akceptować żądania z aplikacji na iOS z podanym przez Ciebie identyfikatorem pakietu, wybierz z listy odpowiedni identyfikator pakietu na iOS.
    • Ograniczenia interfejsów API:
      1. Kliknij Ogranicz klucz.
      2. W menu Wybierz interfejsy API wybierz Google Maps SDK na iOS. Jeśli pakiet Maps SDK na iOS nie jest widoczny na liście, musisz go włączyć.
  4. Aby sfinalizować zmiany, kliknij Zapisz.

Pakiet SDK Cloud

Wyświetl listę istniejących kluczy. 

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

Usuń dotychczasowe ograniczenia dotyczące istniejącego klucza. 

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

Ustaw nowe ograniczenia dotyczące istniejącego klucza. 

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

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

Gdy uzyskasz klucz interfejsu API do pakietu Maps SDK na iOS, możesz zacząć.

Co dalej?

Teraz, gdy masz już klucz interfejsu API, utwórz i skonfiguruj projekt Xcode zgodnie z opisem w sekcji Konfigurowanie projektu Xcode.