Získání klíče rozhraní API služby Mapy Google

Článek
01/10/2024

Pokud chcete používat funkce Google Mapy v Androidu, musíte si zaregistrovat klíč rozhraní API Mapy u Googlu. Dokud to neuděláte, zobrazí se v aplikacích jenom prázdná mřížka místo mapy. Musíte získat klíč Rozhraní API pro Android v2 google Mapy – klíče ze staršího klíče rozhraní Google Mapy Android API v1 nebudou fungovat.

Získání klíče rozhraní API Mapy v2 zahrnuje následující kroky:

Načtěte otisk SHA-1 úložiště klíčů, který se používá k podepsání aplikace.
Vytvořte projekt v konzole Rozhraní API Google.
Získání klíče rozhraní API

Získání otisku podpisového klíče

Pokud chcete požádat o klíč rozhraní API Mapy od Googlu, musíte znát otisk SHA-1 úložiště klíčů, který se používá k podepsání aplikace. Obvykle to znamená, že budete muset určit otisk SHA-1 pro úložiště klíčů ladění a pak otisk SHA-1 pro úložiště klíčů, který se používá k podepsání vaší aplikace k vydání.

Visual Studio
Visual Studio pro Mac

Úložiště klíčů, které se používá k podepisování ladicí verze aplikace Xamarin.Android, najdete v následujícím umístění:

C:\Users\[USERNAME]\AppData\Local\Xamarin\Mono pro Android\debug.keystore

Informace o úložišti klíčů získáte spuštěním keytool příkazu z sady JDK. Tento nástroj se obvykle nachází v adresáři Bin Jazyka Java:

C:\Program Files\Android\jdk\microsoft_dist_openjdk_[VERSION]\bin\keytool.exe

Úložiště klíčů, které se používá k podepisování ladicí verze aplikace Xamarin.Android, najdete v následujícím umístění:

/Users/[USERNAME]/.local/share/Xamarin/Mono pro Android/debug.keystore

Informace o úložišti klíčů získáte spuštěním keytool příkazu z sady JDK. Tento nástroj se obvykle nachází v adresáři Bin Jazyka Java:

/System/Library/Java/JavaVirtualMachines/[VERSION].jdk/Contents/Home/bin/keytool

Spusťte nástroj keytool pomocí následujícího příkazu (pomocí výše uvedených cest k souborům):

keytool -list -v -keystore [STORE FILENAME] -alias [KEY NAME] -storepass [STORE PASSWORD] -keypass [KEY PASSWORD]

Příklad debug.keystore

Pro výchozí ladicí klíč (který se automaticky vytvoří pro ladění) použijte tento příkaz:

Visual Studio
Visual Studio pro Mac

keytool.exe -list -v -keystore "C:\Users\[USERNAME]\AppData\Local\Xamarin\Mono for Android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

keytool -list -v -keystore /Users/[USERNAME]/.local/share/Xamarin/Mono\ for\ Android/debug.keystore -alias androiddebugkey -storepass android -keypass android

Produkční klíče

Při nasazování aplikace do Google Play musí být podepsaný privátním klíčem. Bude keytool potřeba spustit podrobnosti o privátním klíči a výsledný otisk SHA-1 použitý k vytvoření produkčního klíče rozhraní GOOGLE Mapy API. Nezapomeňte aktualizovat soubor AndroidManifest.xml správným klíčem rozhraní API google Mapy před nasazením.

Výstup nástroje Keytool

V okně konzoly by se mělo zobrazit něco podobného jako v následujícím výstupu:

Alias name: androiddebugkey
Creation date: Jan 01, 2016
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

Otisk prstu SHA-1 (uvedený po SHA1) použijete později v této příručce.

Vytvoření projektu rozhraní API

Po načtení otisku prstu SHA-1 podpisového úložiště klíčů je nutné vytvořit nový projekt v konzole Rozhraní GOOGLE API (nebo přidat službu Google Mapy Android API v2 do existujícího projektu).

V prohlížeči přejděte na řídicí panel rozhraní API a služby Google Developers Console a klikněte na Vybrat projekt. Klikněte na název projektu nebo vytvořte nový kliknutím na NOVÝ PROJEKT:
Pokud jste vytvořili nový projekt, zadejte název projektu v zobrazeném dialogovém okně Nový projekt . Toto dialogové okno vytvoří jedinečné ID projektu, které je založeno na názvu projektu. Potom klikněte na tlačítko Vytvořit , jak je znázorněno v tomto příkladu:
Po minutě se projekt vytvoří a přejdete na stránku Řídicí panel projektu. Odtud klikněte na POVOLIT APIS A SLUŽBY:
Na stránce Knihovna rozhraní API klikněte na Mapy SDK pro Android. Na další stránce klikněte na POVOLIT a zapněte službu pro tento projekt:

V tuto chvíli byl projekt rozhraní API vytvořen a do něj byl přidán Google Mapy Android API v2. Toto rozhraní API však nemůžete použít ve svém projektu, dokud pro něj nevytvoříte přihlašovací údaje. V další části se dozvíte, jak vytvořit klíč rozhraní API a autorizovat aplikaci Xamarin.Android k použití tohoto klíče.