• Author / Uploaded
• Arturo Diaz

Citation preview

TEC:143

RD: 180723

TEC: 143

Generación de la API Key para Google Maps

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

Generación de la API Key para Google Maps Los módulos de SoftGuard utilizan el servicio de Google Maps para poder mostrar mapas y geo referenciar direcciones. Dado que Google es el proveedor del servicio de geo-posicionamiento, la utilización del mismo posee algunos requisitos. Uno de ellos es la utilización de un “API Key”. Un “API” consiste de archivos JavaScript que contienen las clases, métodos y propiedades que se usan para el comportamiento de los mapas. De esta forma, para poder utilizar el servicio de Google Maps dentro de las aplicaciones de SoftGuard, cada Central Receptora de Alarmas deberá registrar su propia “API Key”. El proceso de registro es muy sencillo y el usuario podrá optar por distintas opciones de contratación de los servicios de Google. Este tutorial describe el proceso de registro de una “API Key” en forma gratuita.

Procedimiento para el registro de su API Key •

Para comenzar deberá ingresar en la barra de búsquedas de su navegador la siguiente dirección: Enlace: https://developers.google.com/maps/documentation/javascript/get-api-key

•

Y luego seleccione el botón “GET STARTED”.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

•

Posteriormente, se abrirá una ventana en la cual deberán seleccionar las 3 opciones que por defecto aparecen desmarcadas.

•

Al marcar la casilla “Maps” usted estará habilitando las siguientes características:

•

Al marcar la casilla “Routes” usted estará habilitando las siguientes características:

•

Al marcar la casilla “Places” usted estará habilitando las siguientes características:

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

•

Luego, de seleccionar las casillas de “Maps”, “Routes” y “Places”, deberá presionar el botón “Continuar”.

•

Una vez realizado el paso anterior, debe seleccionar un nombre para esta configuración de API Key que está realizando, aceptar los términos del servicio y presionar el botón “Next”

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

•

RD: 180723

Posteriormente Google le pedirá crear una cuenta de facturación como lo muestra la imagen a continuación:

“SG Maps”

•

Presione el botón “Crear cuenta de facturación” y acepte los términos y condiciones para uso del servicio. Al registrarse Google genera un crédito de 300 USD para utilizar en el plazo de 12 meses. Al finalizar el período Google no cobrará nada a menos que se actualice la cuenta de forma manual a una versión de pago.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

•

RD: 180723

Luego, complete los campos requeridos para crear la cuenta de facturación y presione la opción “Iniciar la versión de prueba gratuita”.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

•

Una vez completado el proceso de registro, se debe habilitar la API KEY en la siguiente ventana, para ello pulse el botón “Siguiente”.

•

Inmediatamente, verá en la ventana el código de su API KEY.

•

Por último, pulse el botón “DONE” para finalizar el proceso de generación de la API KEY.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

Panel de administración de la API KEY Desde el margen izquierdo de la ventana, podrá acceder a visualizar todas las API`s que previamente eligió en el proceso de configuración. Acceda a la segunda opción llamada “API´s” para habilitar o deshabilitar cada una de las API de manera individual.

•

En el listado de todas las API solo dejaremos HABILITADAS las utilizadas por la plataforma web y las aplicaciones mobile de SoftGuard

•

Para INHABILTAR una API, hacemos click sobre la misma y luego presionamos el botón “INHABILITAR”

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

A continuación, podremos obtener un resumen de las API que necesitamos tener “Habilitadas” así como también una lista con las API que dejaremos “Inhabilitadas” •

Habilitadas

•

Inhabilitadas

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

Seguridad Podemos asignarle una protección especial a la API, es un procedimiento opcional pero sugerible. Para realizar esta acción, desde la pantalla principal presione la opción “PROTEGER CREDENCIALES” como lo muestra la imagen a continuación:

•

En esta sección se podrán configurar las restricciones para que la API solo pueda ser utilizada en determinadas URL´s o aplicaciones celulares (IOS y Android)

Restricciones de seguridad para determinadas URL´s: •

Seleccione la opción “URLs de referencia HTTP (sitios web)” como lo indica la imagen, y luego ingrese la URL la cual desea configurar para el uso de la API. Al finalizar presione el botón “Guardar” para registrar los cambios.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

Restricciones de seguridad para aplicación Android: •

Seleccione la opción “Aplicaciones para Android” como lo indica la imagen, y luego ingrese el nombre del paquete y la huella digital del certificado de firma SHA-1 para restringir el uso de la API a tu aplicación Android (Puede encontrar el nombre del paquete en el archivo AndroidManifest.xml). pulsa la opción “Añadir nombre de paquete y huella digital” y al finalizar presione el botón “Guardar” para registrar los cambios.

Restricciones de seguridad para aplicación IOS: •

Seleccione la opción “Aplicaciones para iOS” como lo indica la imagen. Luego de manera opcional podrá aceptar las solicitudes de una APP iOS con uno de estos identificadores de conjunto “com.example.MyApp”. Al finalizar presione el botón “Guardar” para registrar los cambios.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

•

RD: 180723

Podrá obtener un detalle y movimiento de solicitudes de las API en el panel remarcado en la imagen que se muestra a continuación:

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

Definir presupuestos y alertas Como ayuda para planificar los proyectos y controlar los costes, puedes establecer un presupuesto, que te permite monitorizar el gasto en relación a la cantidad definida en él. Puedes aplicar un presupuesto tanto a una cuenta de facturación como a un proyecto, así como fijar un importe específico o hacer que coincida con tus gastos del mes anterior. Además, puedes crear alertas para que los administradores de facturación reciban una notificación si la cantidad gastada sobrepasa un porcentaje concreto de tu presupuesto. Para crear un presupuesto, siga los pasos descritos a continuación: •

Ingrese a la consola de Google Cloud Platforn, desde el panel izquierdo, presione la opción llamada “Facturación”.

•

Seleccione la cuenta de facturación vinculada, para administrar el proyecto actual, si desea utilizar otra cuenta de facturación, seleccione la opción “Administrar cuentas de facturación”.

•

En el panel izquierdo, haga clic en la opción “Presupuestos y alertas”

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

•

Haga clic en la opción “Crear presupuesto”

•

Luego, complete los campos que se muestran a continuación:

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

•

En Proyecto o cuenta de facturación, seleccione el proyecto o la cuenta de facturación a la que quiere aplicar el presupuesto. Al aplicar un presupuesto a una cuenta de facturación, el presupuesto refleja los gastos de todos los proyectos asociados a esa cuenta.

•

En Importe del presupuesto, puedes optar por fijar un importe concreto o configurarlo para que coincida con el gasto del mes anterior. El gasto mensual vuelve a ser 0 $ el primer día de cada mes. Si se fija un importe específico para el presupuesto, puede introducirlo. Si, en cambio, prefiere que el presupuesto coincida con el gasto del mes anterior, el importe se actualiza de forma automático.

Si ya tienes los presupuestos configurados y quieres añadir alertas a alguno de ellos, sigue estos pasos:

•

En Porcentaje del presupuesto, introduzca el porcentaje del presupuesto que quiere que active la alerta. El importe de gasto correspondiente se rellena automáticamente. Si lo prefiere, también puede introducir el importe y Google rellenará el porcentaje por usted. Los valores predeterminados son 50 %, 90 % y 100 %, pero puede modificarlos y añadir o quitar campos de alertas.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

•

Para añadir más alertas, haga clic en el signo más (+) que está debajo de la lista de alertas para añadir más campos.

•

Para quitar una alerta, haga clic en la (X) ubicada al costado de cada alerta.

•

Para finalizar la configuración actual del presupuesto y las alertas, haga clic en la opción “Guardar”.

Si lo requiere, podrá crear un nuevo presupuesto, modificarlo o eliminarlo desde la pantalla principal de “Presupuestos y alertas”

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

RD: 180723

Configuración en DSS “Desktop Security Suite” •

Para el uso de los mapas en los módulos de la plataforma DSS, acceda a: >> Módulo Administrador >> Sistema >> Configuración >> Parámetros

•

Utilice el filtro de búsqueda para localizar le parámetro “KEYGOOGLEMAPS” y pegue la “API Key” creada previamente.

•

Para terminar, presione el botón “Guardar”.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com

TEC:143

•

RD: 180723

Para el uso de los mapas dentro de la aplicación SmartPanics acceda a: >> Módulo SmartPanics >> Configurar servicio >> Datos

•

En el campo “Key Google” pegue la “API Key” creada previamente.

SoftGuard – 20900 NE 30th Avenue, Suite # 200 – Aventura – Florida 33180 Phone +1 (786) 866.2138 / [email protected] - www.softguard.com