Si estás desarrollando un complemento de Google Maps Platform para plataformas como WordPress, Shopify, Magento y otras, en este tema se describe cómo integrar a los usuarios del complemento a Google Maps Platform y generar una clave de API con rapidez.
La clave de API, que el complemento necesita enviar con cada solicitud a Google Maps Platform, está vinculada a la Cuenta de Google del usuario y a los datos de facturación, y desbloquea el acceso a las funciones de creación de mapas en tu complemento.
Para ayudar a los usuarios del complemento a generar rápidamente una clave de API, proporciona un vínculo o botón que abra el widget de inicio rápido, una ventana emergente práctica que guía a los usuarios para hacerlo mediante unos pocos pasos simples. 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 que realicen esas tareas en varias ventanas.
Abre el widget de inicio rápido
El widget de inicio rápido es solo una página web en la que puedes controlar el tamaño de ventana 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 se mueve 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 copien y peguen en la configuración del complemento.
Si el usuario del complemento ya tiene una Cuenta de Google y un proyecto, el widget lo lleva 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 Información sobre el widget de inicio rápido para obtener 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 creadores de sitios web o sitios de comercio electrónico.
¿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 la información de facturación y demás datos. 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 redireccionará a la consola de Google Cloud, donde podrás 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 la API, 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.