Otrzymywanie klucza interfejsu API

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Zanim zaczniesz

Zanim zaczniesz korzystać z pakietu SDK Miejsc na iOS, potrzebujesz projektu z kontem rozliczeniowym i włączonym pakietem Places SDK na iOS. Więcej informacji znajdziesz w artykule Konfiguracja w konsoli Cloud.

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:

• gcloud alpha services api-keys create

Uwaga: możesz użyć tego samego klucza interfejsu API w aplikacjach Maps SDK na iOS i Places SDK na iOS.

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.

W przypadku ograniczania klucza interfejsu API w konsoli Cloud Ograniczenia aplikacji zastępują wszystkie interfejsy API włączone w sekcji Ograniczenia interfejsów API. Postępuj zgodnie ze sprawdzonymi metodami, tworząc oddzielny klucz interfejsu API dla każdej aplikacji i platformy, na której aplikacja jest dostępna.

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 Places API z menu Wybierz interfejsy API. Jeśli interfejsu Places API 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="places-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

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

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

Co dalej

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