Korzystanie z kluczy interfejsu API

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Zanim zaczniesz

Zanim zaczniesz korzystać z pakietu SDK Miejsc na Androida, musisz mieć projekt z kontem rozliczeniowym i Włączono SDK Miejsc na Androida. Więcej informacji znajdziesz w artykule Konfiguracja w konsoli Cloud.

Tworzę klucze interfejsu API

Uwaga: jeśli używasz zarówno obecnych Pakiet SDK Miejsc na Androida i pakiet SDK Miejsc na Androida (nowość), który można włączyć za pomocą tego samego klucza interfejsu API.

Klucz interfejsu API to unikalny identyfikator, który uwierzytelnia żądania powiązane z projektem w: 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 Google Maps Platform > Dane logowania.

   Otwórz stronę Dane logowania

2. Na stronie Dane logowania kliknij Utwórz dane logowania > 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 o ograniczeniu dostępu do interfejsu API przed użyciem w środowisku produkcyjnym).

Pakiet SDK Cloud

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Przeczytaj więcej na temat Pakiet SDK Google Cloud , Instalacja pakietu SDK Cloud oraz tych poleceń:

• gcloud alpha services api-keys create

.

.

Uwaga: możesz użyć tego samego klucza interfejsu API w przypadku Maps SDK na Androida oraz SDK Miejsc dla aplikacji na Androida.

Ograniczanie kluczy interfejsu API

Zdecydowanie zalecamy ograniczenie użycia kluczy API do tych, które Interfejsy API potrzebne do aplikacji. Ograniczenie kluczy interfejsu API zwiększa bezpieczeństwo aplikacji przez i chronić je przed nieuzasadnionymi żądaniami. Więcej informacji: Sprawdzone metody zabezpieczania interfejsów API

Jeśli ograniczasz klucz 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 każdej platformy na których ta aplikacja jest dostępna.

W przypadku ograniczenia klucza interfejsu API musisz podać odcisk cyfrowy certyfikatu SHA-1 który został użyty do podpisania aplikacji. Istnieją 2 typy certyfikatów:

• Certyfikat debugowania: używaj tego typu certyfikatu tylko w przypadku testowanych aplikacji. oraz inny nieprodukcyjny kod. Nie próbuj publikować aplikacji podpisanej za pomocą kodu debugowania certyfikat. Narzędzia Android SDK generują ten certyfikat automatycznie podczas debugowania tworzyć.
• Opublikuj certyfikat: użyj tego certyfikatu, gdy chcesz udostępnić swój do sklepu z aplikacjami. Narzędzia Android SDK generują ten certyfikat podczas uruchamiania kompilacji wersji.

Więcej informacji o podpisywaniu aplikacji na Androida i certyfikatach znajdziesz w Podpisywanie aplikacji Google.

Instrukcje dotyczące znajdowania odcisku cyfrowego certyfikatu podpisywania znajdziesz w tych materiałach:

• Jeśli używasz podpisywania aplikacji przez Google Play, zapoznaj się z sekcją Współpraca z dostawcami interfejsów API.
• Jeśli samodzielnie zarządzasz kluczem podpisywania, zobacz Samodzielne podpisywanie zgłoszenia. lub zapoznaj się z instrukcjami dotyczącymi Twojego środowiska kompilacji.

Aby ograniczyć klucz interfejsu API:

Konsola

1. Otwórz 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 Androida.
2. Kliknij + Dodaj nazwę pakietu i odcisk cyfrowy.
3. Wpisz nazwę pakietu i odcisk cyfrowy certyfikatu SHA-1. Na przykład:

   com.example.android.mapexample

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

• Ograniczenia interfejsów API:
1. Kliknij Ogranicz klucz.
2. Wybierz Places API lub Places API (nowy). z menu Wybierz interfejsy API, ale nie oba jednocześnie. Jeśli interfejsu Places API nie ma na liście, musisz: włącz ją.
   Uwaga: jeśli używasz zarówno obecnych Places API i Places API (nowość), zalecamy utworzenie oddzielny klucz API dla każdej wersji API.
4. Aby zastosować zmiany, kliknij Zapisz.
   

Pakiet SDK Cloud

Pakiet SDK Miejsc na Androida (nowość)

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.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Przeczytaj więcej na temat Pakiet SDK Google Cloud , Instalacja pakietu SDK Cloud oraz tych poleceń:

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

Pakiet SDK Miejsc na Androida

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-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Przeczytaj więcej na temat Pakiet SDK Google Cloud , Instalacja pakietu SDK Cloud oraz tych poleceń:

• 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 na stronie Konfigurowanie projektu w Android Studio