Konfigurieren von Android-Anwendungen für die Verwendung von Google Maps

Nach oben zu Mobile-Tutorial: Verwenden einer Landkarten-Komponente für die Arbeit mit Landkarten (iOS und Android)

In diesem Thema wird gezeigt, wie Android-Anwendungen für die Verwendung der TMapView-Komponente und der Google Maps Android API konfiguriert werden.

Folgende Bereiche werden behandelt:

• Abrufen des API-Schlüssels für Android
• Konfigurieren von bestimmten Projektoptionen

Abrufen des API-Schlüssels für Android

Um auf die Google Maps-Server mit der Google Maps Android API zuzugreifen, müssen Sie Ihrer Anwendung einen Android API-Schlüssel hinzufügen. In diesem Abschnitt werden die grundlegenden Schritte zum Abrufen des Schlüssels dargestellt:

1. Abrufen von Informationen über das Zertifikat Ihrer Anwendung.
2. Registrieren eines Projekts in der Google API Console und aktivieren der Google Maps Android API für dieses Projekt.
3. Einrichten des Android API-Schlüssels.

Wichtig In diesem Abschnitt wird beschrieben, wie Sie den Google Maps Android API-Schlüssel über die Google API Console abrufen. Die Benutzeroberfläche dieser Konsole, einschließlich der Namen von Steuerelementen, kann ohne Ankündigung geändert werden. Informationen über die neueste Version der Google API Console finden Sie in der entsprechenden Google-Dokumentation.

Abrufen Ihres Anwendungszertifikats

Der Maps-API-Schlüssel basiert auf einer Kurzform des digitalen Zertifikats Ihrer Anwendung, auch als SHA-1-Fingerabdruck bezeichnet. Der Fingerabdruck ist ein eindeutiger Text-String, der mit dem allgemein verwendeten SHA-1-Hash-Algorithmus generiert wird. Sie können Zertifikate der beiden folgenden Typen haben: Debug-Zertifikat und Release-Zertifikat.

Hinweis: In diesem Abschnitt wird erklärt, wie Sie das Debug-Zertifikat abrufen. Informationen über das Abrufen des Release-Zertifikats finden Sie unter Get an Android certificate and the Google Maps API key (EN).

So zeigen Sie den Fingerabdruck des Debug-Zertifikats an:

1. Suchen Sie die entsprechende debug.keystore-Datei. RAD Studio verwendet die debug.keystore-Datei aus dem Verzeichnis:
   %Benutzer%\<Benutzername>\AppData\Roaming\Embarcadero\BDS\<Versionsnummer>\, zum Beispiel:
   C:\Benutzer\JohnDoe\AppData\Roaming\Embarcadero\BDS\19.0\debug.keystore

   Tipp: Wenn Sie die debug.keystore-Datei in dem oben erwähnten Verzeichnis nicht finden können, führen Sie Ihre Anwendung auf der Android-Zielplattform aus, und diese Datei wird dann automatisch von RAD Studio erstellt.

   
   
2. Suchen Sie die Datei keytool.exe. Das Tool keytool ist im <Java-Installationsordner>\BIN verfügbar, zum Beispiel:
   C:\Programme\Java\jdk1.7.0_71\BIN\.
   
3. Wechseln Sie zu dem Ordner, in dem sich die Datei debug.keystore befindet, und führen Sie folgenden Befehl aus:
   keytool -list -v -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android
   

   Tipp: Sie müssen den vollständigen Pfad zu keytool hinzufügen; wenn sich die Datei keytool.exe in dem oben angegebenen Beispiel befindet, können Sie folgenden Befehl verwenden:
   

   "C:\Programme\Java\jdk1.7.0_71\BIN\keytool" -list -v -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android

   
   
4. Die Ausgabe des Tools keytool entspricht weitgehend Folgendem: Alias name: androiddebugkey Creation date: Jan 24, 2015 Entry type: PrivateKeyEntry Certificate chain length: 1 Certificate[1]: Owner: CN=Unnamed, OU=Mobile Organization, O=My Company, L=San Francisco, ST=California, C=US Issuer: CN=Unnamed, OU=Mobile Organization, O=My Company, L=San Francisco, ST=California, C=US Serial number: 1af9d77f Valid from: Sat Jan 24 23:12:12 GST 2015 until: Wed Jun 11 23:12:12 GST 2042 Certificate fingerprints: MD5: 20:E1:7D:12:4F:83:2A:37:FB:F5:43:3B:CC:27:88:4B SHA1: 0B:4D:1E:83:2F:91:3A:BD:92:EB:87:62:6D:34:66:9D:6A:51:3B:ED SHA256: 91:75:AC:BE:C9:74:6F:67:3E:9A:E4:35:04:D4:05:E0:8F:A4:54:30:41:4A:EB:0A:61:E0:D1:33:7C:D8:0F:82 Signature algorithm name: SHA256withRSA Version: 3 Die Zeile, die mit SHA1 beginnt, enthält den SHA-1-Fingerabdruck des Zertifikats. Der Fingerabdruck ist eine Folge von 20 zweiziffrigen hexadezimalen Zahlen, die durch Doppelpunkt getrennt sind.

Erstellen eines API-Projekts in der Google API Console

Wichtig: Bevor Sie mit diesem Abschnitt fortfahren, müssen Sie über ein Google-Konto verfügen.

1. Wechseln Sie zur Google API Console.
2. Wählen Sie in der Projektliste Projekt erstellen.
3. Geben Sie einen Namen ein, und legen Sie eine Projekt-ID fest, oder akzeptieren Sie die Vorgabe-ID.
4. Klicken Sie auf Erstellen.

Einrichten eines Android API-Schlüssels

Jetzt können Sie einen Android API-Schlüssel einrichten. Sie können mehr als einen Schlüssel pro Projekt registrieren.

So richten Sie einen Android API-Schlüssel ein:

1. Navigieren Sie in der Google API Console zu Ihrem Projekt.
2. Klicken Sie links auf der Seite "API Manager" auf Zugangsdaten.
3. Klicken Sie auf Anmeldedaten erstellen, und wählen Sie dann API-Schlüssel aus.
4. Klicken Sie auf der Seite Neuen Schlüssel erstellen auf Android-Schlüssel.
5. Klicken Sie im Ergebnisdialogfeld auf die Schaltfläche + Paketname und Fingerabdruck hinzufügen, und geben Sie die entsprechenden Informationen in Paketname und SHA1-Zertifikatfingerabdruck ein.

   Wichtig: Achten Sie darauf, den genauen Paketnamen der Anwendung einzugeben, damit Sie einen gültigen Android API-Schlüssel erhalten. Dieser Name identifiziert Ihre Anwendung eindeutig. Der package-Schlüssel in den Android-Versionsinformationen enthält den Paketnamen (siehe den Screenshot bei der Anleitung "So legen Sie den apiKey-Schlüsselwert fest" weiter unten in diesem Thema).

6. Klicken Sie auf Erstellen.
   In der Google API Console wird das Fenster API-Schlüssel mit einem 40 Zeichen langen API-Schlüssel angezeigt. Zum Beispiel: API-Schlüssel: AIzaSyCMuJ2w8_gQEedvqUg-9lxWXFg7feAl9PQ

Konfigurieren von bestimmten Projektoptionen

Damit Android-Anwendungen auf Google Maps zugreifen können, müssen Sie die folgenden Projektoptionen und Berechtigungen konfigurieren:

• Aktivieren Sie die entsprechenden Verwendungsberechtigungen.
• Aktivieren Sie die Berechtigungsoption Kartendienst.
• Geben Sie in den Android-Versionsinformationen den apiKey-Schlüsselwert an.

Wichtig: Setzen Sie in der Projektverwaltung die Zielplattform auf Android, bevor Sie mit diesem Abschnitt fortfahren:

So überprüfen Sie die konfigurierte Berechtigungsliste:

1. Öffnen Sie in der RAD Studio-IDE Projekt > Optionen > Verwendet Berechtigungen.
2. Stellen Sie sicher, dass Sie die folgenden Berechtigungen aktiviert haben:
   • Auf ungefähren Standort zugreifen
   • Auf genauen Standort zugreifen
   • Auf Netzwerkstatus zugreifen

   

So überprüfen Sie die Berechtigungsliste:

1. Öffnen Sie in der RAD Studio-IDE Projekt > Optionen > Berechtigungsliste.
2. Stellen Sie sicher, dass die Option Kartendienst aktiviert ist:
   

So legen Sie den apiKey-Schlüsselwert fest:

1. Öffnen Sie in der RAD Studio-IDE Projekt > Optionen > Versionsinformationen.
2. Setzen Sie den apiKey-Schlüssel auf den Wert des Android API-Schlüssels, den Sie für Ihre Anwendung angefordert haben (siehe Schritt 6 im Abschnitt Einrichten eines Android API-Schlüssels weiter oben in diesem Thema).
3. Klicken Sie auf OK.
   

Wichtig: Damit die Änderungen der Projektoptionen wirksam werden, drücken Sie Umschalt+F9, um Ihr Projekt neu zu erzeugen.

Siehe auch

• TMapView
• Mobile-Tutorial: Verwenden einer Landkarten-Komponente für die Arbeit mit Landkarten (iOS und Android)

Codebesipiele

• Tabbed Map (Beispiel)
• Map (Beispiel)