Jeśli pracujesz nad wtyczką Google Maps Platform na platformy takie jak WordPress, Shopify, Magento i inne, w tym temacie opisujemy, jak szybko wprowadzać użytkowników wtyczki do Google Maps Platform i generować klucz interfejsu API.
Klucz interfejsu API, który Twoja wtyczka musi wysyłać z każdym żądaniem do Google Maps Platform, jest powiązany z kontem Google użytkownika i informacjami rozliczeniowymi oraz odblokowuje dostęp do funkcji tworzenia map we wtyczce.
Aby pomóc użytkownikom wtyczki w szybkim wygenerowaniu klucza interfejsu API, podaj link lub przycisk, który uruchamia widżet Szybki start – wygodne wyskakujące okienko z instrukcjami wykonania kilku prostych czynności. Widżet Szybki start utrzymuje użytkowników wtyczki na Twojej platformie, zamiast wysyłać ich do konsoli Google Cloud, aby mogli wykonywać te zadania w wielu oknach.
Uruchamianie widżetu Szybki start
Widżet Szybki start to po prostu strona internetowa, której rozmiar okna można kontrolować za pomocą wywołania window.open JavaScript. Na przykład:
<script>
function openPopupWindow() {
var winWidth=570;
var winHeight=700;
var left = (screen.width-winWidth)/2;
var top = (screen.height-winHeight)/2;
window.open('https://console.cloud.google.com/google/maps-hosted', 'Quick Start Widget',
'resizable=yes,width='+winWidth+',height='+winHeight+',left='+left+',top='+top);
return false;
}
</script>
<!-- CTA to generate Google Maps API Key -->
<button type="button" onClick="openPopupWindow()" style="color: white; background-color: #1a73e8" href="#">
Get an API Key
</button>
Zobacz, jak to działa
Gdy użytkownik kliknie ten przycisk, w wyskakującym okienku zostanie otwarty widżet Szybki start i podczas poruszania się po widżecie wykona te czynności:
- Tworzy konto Google i projekt, jeśli użytkownik jeszcze ich nie ma.
- Włącza interfejsy Google Maps Platform API.
- Generuje klucz interfejsu API, który użytkownicy mogą skopiować i wkleić do konfiguracji wtyczki.
Jeśli użytkownik wtyczki ma już konto i projekt Google, widżet przeniesie go na stronę „Dane logowania” w konsoli Google Cloud, gdzie będzie mógł uzyskać istniejący klucz interfejsu API lub utworzyć nowy.
Możesz skierować użytkowników wtyczki do tematu Informacje o widżecie Szybki start, w którym znajdą więcej informacji.
Najczęstsze pytania
Czy korzystanie z widżetu Szybki start jest płatne?
Nie. Widżet Szybki start jest bezpłatny i dostępny dla wszystkich deweloperów, aby ułatwić rozpoczęcie korzystania z Google Maps Platform.
Czy widżetu Szybki start można używać tylko w WordPressie i Shopify?
Widżetu Szybki start można używać w dowolnej witrynie zewnętrznej, nie tylko w kreatorze witryn czy w witrynach e-commerce.
Czy platforma innej firmy może wyświetlać informacje rozliczeniowe podawane przez użytkownika?
Po uwierzytelnieniu użytkowników w Google informacje rozliczeniowe i inne informacje są dostępne tylko dla nich. Platformy i deweloperzy wtyczek innych firm nie mają dostępu do tych informacji.
Czy mogę używać istniejącego projektu i klucza interfejsu API?
Jeśli masz już konto Google Maps Platform, widżet szybkiego startu przekieruje Cię do konsoli Google Cloud, w której możesz użyć istniejącego klucza interfejsu API lub wygenerować nowy.
W jaki sposób użytkownicy wtyczki zabezpieczają swoje klucze interfejsu API?
Wskazówki dotyczące zabezpieczania klucza interfejsu API znajdziesz w artykule Sprawdzone metody zapewniania bezpieczeństwa interfejsów API. Po użyciu widżetu Szybki start użytkownicy otrzymają też e-maila z instrukcjami i linkiem do konsoli Google Cloud umożliwiającej zabezpieczenie klucza interfejsu API.