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
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
-
Otwórz Google Maps Platform > Dane logowania.
-
Na stronie Dane logowania kliknij Utwórz dane logowania > API.
W oknie Utworzono klucz interfejsu API pojawi się nowo utworzony klucz interfejsu API. -
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ń:
.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
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
-
Otwórz Google Maps Platform > Dane logowania.
- Wybierz klucz interfejsu API, dla którego chcesz zastosować ograniczenie. Pojawi się strona właściwości klucza interfejsu API.
- W sekcji Ograniczenia kluczy ustaw te ograniczenia:
- Ograniczenia aplikacji:
- Wybierz Aplikacje na Androida.
- Kliknij + Dodaj nazwę pakietu i odcisk cyfrowy.
- 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:
- Kliknij Ogranicz klucz.
- 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ą.
- 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ń:
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ń:
Co dalej?
Po uzyskaniu klucza interfejsu API utwórz i skonfiguruj projekt zgodnie z opisem na stronie Konfigurowanie projektu w Android Studio