Si estás desarrollando un complemento de Google Maps Platform para plataformas como WordPress, Shopify, Magento y otras, este tema describe cómo integrar rápidamente a los usuarios del complemento en Google Maps Platform y generar una clave de API.
La clave de API, que tu complemento debe enviar con cada solicitud a Google Maps Platform, está vinculada a la cuenta de Google y a los datos de facturación del usuario, y desbloquea el acceso a las funciones para crear mapas de tu complemento.
Para ayudar a los usuarios del complemento a generar una clave de API rápidamente, proporciona un vínculo o un botón que abra el widget de inicio rápido, una ventana emergente útil que guía a los usuarios por unos pocos simples pasos. El widget de inicio rápido también mantiene a los usuarios del complemento en tu plataforma en lugar de enviarlos a la consola de Google Cloud para realizar esas tareas en varias ventanas.
Abre el widget de inicio rápido
El widget de inicio rápido es simplemente una página web cuyo tamaño de ventana puedes controlar con una llamada a window.open de JavaScript. Por ejemplo:
<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>
Obsérvalo en acción:
Cuando un usuario hace clic en el botón, el widget de inicio rápido se abre en una ventana emergente y hace lo siguiente a medida que el usuario navega por el widget:
- Crea una Cuenta de Google y un proyecto si el usuario aún no los tiene.
- Habilita las APIs de Google Maps Platform.
- Genera una clave de API para que los usuarios la copien y la peguen en la configuración del complemento.
Si el usuario del complemento ya tiene una Cuenta de Google y un proyecto, el widget lo llevará a la página "Credenciales" de la consola de Google Cloud, donde puede obtener una clave de API existente o crear una nueva.
Puedes dirigir a los usuarios de tu complemento al tema Acerca del widget de inicio rápido para que obtengan más información.
Preguntas frecuentes
¿Tengo que pagar para usar el widget de inicio rápido?
No. El widget de inicio rápido es gratuito y está disponible para todos los desarrolladores para simplificar la integración en Google Maps Platform.
¿El widget de inicio rápido solo se puede usar en WordPress y Shopify?
El widget de inicio rápido se puede usar en cualquier sitio web de terceros, no solo en aquellos de comercio electrónico o creadores de sitios web.
¿La plataforma de terceros puede ver los datos de facturación que ingresa un usuario?
Después de que los usuarios se autentican con Google, solo ellos pueden acceder a sus datos de facturación y demás información. Las plataformas de terceros y los desarrolladores de complementos no pueden acceder a esa información.
¿Puedo usar mi proyecto y clave de API existentes?
Si ya tienes una cuenta de Google Maps Platform, el widget de inicio rápido te redirigirá a la consola de Google Cloud, donde puedes usar una clave de API existente o generar una nueva.
¿Cómo protegen sus claves de API los usuarios de complementos?
En el tema Prácticas recomendadas sobre la seguridad de las APIs, se proporciona orientación para proteger las claves de API. Después de usar el widget de inicio rápido, los usuarios también recibirán un correo electrónico con instrucciones y un vínculo a la consola de Google Cloud para proteger su clave de API.