API Keys für den Filialfinder einrichten - novacore.de · Version 0.6 - 28.08.2018 Achtung: Google Maps ist nicht kostenlos. Momentan gibt Google gibt jedem Benutzer von Maps und

Version 0.6 - 28.08.2018

Achtung: Google Maps ist nicht kostenlos. Momentan gibt Google gibt jedem Benutzervon Maps und den damit verbundenen Diensten ein Kontingent von 200$ pro Monat.Wenn das Kontingent aufgebraucht ist fallen Kosten an. Schränken Sie unbedingt IhreAPI Keys auf Domain bzw. Server ein und kontrollieren Sie den Verbrauch. Laut Googleist es auch möglich sich Warnungen beim Überschreiten bestimmter Budgets zukommenzu lassen. Bedenken Sie auch dass sich diese Dinge ändern können und informieren Siesich bitte regelmäßig auf den Seiten von Google.

Informationen zu den Preisen finden Sie unter: https://cloud.google.com/maps-platform/pricing/?hl=de

Eine Anleitung für die Warnungen befindet sich hier: https://cloud.google.com/billing/docs/how-to/budgets?hl=de

Google Maps PlatformMelden Sie sich mit Ihrem Google Konto unter https://cloud.google.com/maps-platform/ an. Falls Sie kein Konto besitzen müssen Sie zuerst ein Google Kontoanlegen. Klicken Sie anschließend auf der Website den Button "JETZT STARTEN" undwählen Sie alle drei Optionen aus.

API Keys für den Filialfinder einrichten

API KEYS FÜR DEN FILIALFINDER EINRICHTEN 1

https://cloud.google.com/maps-platform/pricing/?hl=de

https://cloud.google.com/maps-platform/pricing/?hl=de

https://cloud.google.com/billing/docs/how-to/budgets?hl=de

https://cloud.google.com/billing/docs/how-to/budgets?hl=de

https://cloud.google.com/maps-platform/

https://cloud.google.com/maps-platform/



Projekt erstellenIm nächsten Schritt muss ein neues Projekt erstellt werden. Hier sollten Sie einenNamen vergeben, den Sie später leicht zuordnen können, falls Sie einmal mehrereProjekte haben (z.B. auf die geplante Website bezogen).

Zahlungsweise hinterlegenDie Google Maps Platform verlangt ab August/September 2018 das Hinterlegen vonZahlungsmitteln. Die Kosten für die Verwendung von Google Maps richten sich nachdem Verbrauch, also beispielsweise Anzahl der Kartenaufrufe und Geokodierung.



Google gibt an, dass die ersten 200$ an Verbrauch für jeden Benutzer "kostenlos" sind,also nicht berechnet werden. Damit lässt sich also schon eine recht intensive Nutzungohne Aufpreise decken. Wenn sich die Verwendung des Filialfinders etabliert hat unddie Zugriffe hohe Zahlen erreichen, können also auch Kosten anfallen. Aus diesemGrund sollten in einem späteren Schritt der öffentliche API Key unbedingt auf dieDomain beschränkt werden, um Fremdbenutzung und damit entstehende Kosten zuunterbinden.

Weitere Hinweise zu den Preisen finden Sie auf den Seiten von Google. Eine Übersichtgibt es momentan unter dieser URL: https://cloud.google.com/maps-platform/pricing/

Bitte informieren Sie sich darüber ab welchen Kontingenten Kosten über Google auf Siezukommen können. Eine Einschätzung dürfte möglich sein wenn Ihnen die ungefährenZugriffe auf Ihre Webseite bekannt sind. Wir übernehmen in dem Zusammenhang keineVerantwortung für das Anfallen von Kosten. Bitte denken Sie auch unbedingt daran IhreSchlüssel für die Zugriffe einzuschränken (mehr dazu weiter unten beim ThemaSchlüssel anlegen).



https://cloud.google.com/maps-platform/pricing/

Zur Konsole wechseln und Projekt auswählenFür die Projekt-Einstellungen und die Aktivierung der APIs klicken Sie oben rechts auf"KONSOLE". Alternativ besuchen Sie diesen Link: https://console.cloud.google.com/

Innerhalb der Konsole müssen Sie darauf achten, dass Sie für Änderungen oben dasrichtige Projekt ausgewählt haben oder ein neues Projekt anlegen (1). Als nächstenSchritt müssen Sie die benötigten Maps APIs für das Projekt aktivieren. Es gibtverschiedene Wege zu verfügbaren APIs zu gelangen, z.B. direkt auf der Startseiteeines Projektes oder über das Hauptmenü auf der linken Seite. Die benötigten APIssind: Places API, Maps JavaScript API, Directions API und Geocoding API.



https://console.cloud.google.com/



API Schlüssel für serverseitige Abfragen erstellenKlicken Sie anschließend auf der linken Seite auf Zugangsdaten und wählen SieAnmeldedaten erstellen > API Schlüssel

Schlüssel kopierenKopieren Sie sich diesen Schlüssel in die Zwischenablage. Diesen Schlüsselverwenden wir für die serverseitige Geokodierung. Der Schlüssel kann später nur mitBackend-Zugang eingesehen werden. Wenn Ihnen die IP Ihres Servers bekannt ist, und



diese auch dauerhaft gleich bleibt, wäre eine Einschränkung auf Basis der IP sinnvoll(Schlüssel einschränken klicken und bei Anwendungseinschränkung "IP-Adressen"wählen). Wechseln Sie dann zum Joomla-Backend.



Server-Schlüssel im Backend einfügenDer soeben erstellte Server-Schlüssel kann nun kopiert und im Backend, in denEinstellungen des Filialfinders, in das vorgesehene Feld kopiert werden.



Browser-Schlüssel erstellenJetzt möchten wir einen zweiten Schlüssel erstellen, den wir dieses mal auf die Domaineinschränken werden. Er wird im Quellcode der Website einsehbar sein und könnte vonanderen missbraucht werden.

Schlüssel einschränkenAls nächstes wollen wir nun unseren zweiten Schlüssel einschränken, so dass diesernur über unsere Domain verwendet werden kann. Hier ist die Auswahl "HTTP-Verweis"



die richtige Wahl. Wenn es hier fehlerhafte Einstellungen gibt, wird die Umkreissuchenicht funktionieren und Karten können nicht angezeigt werden (Fehlerursachen werdenin der JavaScript Konsole des Browsers aufgeführt). Die Änderungen brauchen ein paarMinuten bis diese aktiv sind. Zu Testzwecken kann ein Key auch mal uneingeschränktbenutzt werden, aber spätestens wenn die Website öffentlich einsehbar wird, solltenhier die richtigen Daten eingetragen werden. Achten Sie darauf, dass auch Subdomains(www.) berücksichtigt werden müssen (in diesem Beispiel mit einem Platzhalter gelöst*.domain.de/*) - aber auch ohne Subdomain muss es in manchen Fällen funktionieren,deshalb im Screen zwei Einträge sichtbar sind. Auch die Sternchen am Ende desEintrages, nach dem Slash, sind wichtig. Kopieren Sie nun auch diesen Schlüssel undklicken Sie auf speichern.





Schlüssel im Backend einfügenDer zweite Schlüssel kann nun im Backend in das vorgesehen Feld eingefügt werden(speichern der Änderungen nicht vergessen)

Abschluss und TestIn der Übersicht sollten Sie nun zwei API Schlüssel haben. Der eine mit Einschränkung(Verweis-URL), in Joomla als Browser-Key hinterlegt und den anderen als Server-Keyohne Einschränkung. Wenn Ihnen die IP Ihres Servers bekannt ist, empfehlen wir eine



Einschränkung beim "Server-Key" einzufügen, jedoch wechseln diese IPs bei manchenWebhostern.

API Zugriffe und Adress VervollständigungDurch die neuen Preise bei Google müssen Sie auf Ihren Verbrauch achten. DieVerwendung von Vorschlägen bei der Adresseingabe durch die Kunden können vieleAPI-Abfragen entstehen. Wenn Sie das Feature verwenden sollten Sie dieentstehenden Abfragen an Google kontrollieren. Wenn Sie wissen aus welchen LändernIhre Kunden kommen sollten Sie die Vorschläge auch auf diese Länder einschränkenum unsinnige Vorschläge zu vermeiden. Auch die Optimierung im Bezug auf denStandort des Kunden ist sinnvoll (nur bei https Webseiten).



Frontend testenNach ein paar Minuten sollten nun die Keys funktionieren. Um die Funktion direkt zutesten können Sie beispielsweise im Backend auf den Punkt "Geokodierung" gehen.Dort sollten Sie dann eine Karte angezeigt bekommen. Wenn dies nicht der Fall istempfiehlt es sich noch kurz zu warten. Falls es dann immer noch nicht geht können Siedie JavaScript Konsole Ihres Browser öffnen und nachsehen, ob Ihr Browser Fehler undRückmeldungen von Google anzeigt, welche darüber Aufschluss geben können warumeine Karte nicht angezeigt wird. Dies geht z.B. ganz gut in den Chrome DevToolshttps://developers.google.com/web/tools/chrome-devtools/



https://developers.google.com/web/tools/chrome-devtools/

Documents

API Keys für den Filialfinder einrichten - novacore.de · Version 0.6 - 28.08.2018 Achtung: Google Maps ist nicht kostenlos. Momentan gibt Google gibt jedem Benutzer von Maps und