Crear claves de API de Google Maps

WP-ImmoMakler requiere dos claves de API de Google Maps separadas: una clave del lado del servidor para operaciones en segundo plano y una clave del lado del navegador para la visualización de mapas en su sitio web.

Requisitos previos

Para utilizar las APIs de Google Maps se necesita una cuenta de Google con una cuenta de facturación vinculada. Google exige proporcionar una cuenta bancaria o tarjeta de crédito, incluso si no supera la cuota gratuita. En la práctica, incluso los agentes inmobiliarios con varios cientos de inmuebles y un alto tráfico en su sitio web se mantienen dentro de la cuota mensual gratuita, por lo que normalmente no se generarán costes adicionales.

Clave 1: Clave de API del lado del servidor

Esta clave se utiliza para las siguientes funciones:

• Geocodificación automática de ubicaciones de inmuebles (Geocoding API)
• Mapas en la vista de impresión PDF (Maps Static API)
• Autocompletado de direcciones en el backend (Places API)

APIs a configurar:

• Geocoding API
• Places API (New)
• Maps Static API

Restricción: Restrinja esta clave a la dirección IP de su servidor. La dirección IP de su servidor se muestra directamente en los ajustes de WP-ImmoMakler.

Clave 2: Clave de API del lado del navegador (JavaScript API Key)

Esta clave se utiliza para las siguientes funciones:

• Visualización de mapas en su sitio web (Maps JavaScript API)
• Autocompletado de direcciones en el formulario de búsqueda (Places API)

APIs a configurar:

• Maps JavaScript API
• Places API

Restricción: Restrinja esta clave a referentes HTTP, es decir, al dominio o dominios de su sitio web. Añada un asterisco comodín al final del dominio para que todas las subpáginas funcionen correctamente, por ejemplo: https://www.su-sitio-web.es/*

¿Por qué dos claves separadas?

La clave del lado del navegador es visible públicamente en el código fuente de su sitio web. Por razones de seguridad, las claves de API deben restringirse para que ningún tercero pueda utilizarlas a su costa. Sin embargo, una sola clave de API solo puede restringirse a direcciones IP o a nombres de dominio, no a ambos al mismo tiempo. Como las APIs de Geocoding y Static Maps son llamadas desde el servidor (restricción a la IP del servidor) y las APIs de JavaScript y Places lo son desde el navegador de sus visitantes (restricción al dominio referente), necesita dos claves distintas.

Introducir las claves de API en WP-ImmoMakler

Introduzca las claves creadas en el backend de su sitio web (wp-admin) en WP-ImmoMakler → Integraciones. Se encuentran en dos pestañas distintas, porque cumplen dos funciones diferentes:

• La clave del lado del navegador en la pestaña Mapas, en el campo de la clave JavaScript. Es necesaria para los mapas en el navegador de sus visitantes.
• La clave del lado del servidor en la pestaña Servicios de geolocalización, en el campo de la clave de Geocoding. Es necesaria para la geocodificación, las imágenes de vista previa del mapa y las sugerencias de direcciones.

Si tiene problemas con la configuración de las claves, no dude en ponerse en contacto con nuestro soporte. Estaremos encantados de configurar las claves juntos mediante pantalla compartida.

Si desea diseñar sus mapas de forma individual o resaltar en color las zonas de código postal, necesita además un ID de mapa propio; véase Crear un ID de mapa de Google Maps.

Ubicación del proxy Fast-API para el autocompletado de direcciones

Para que el autocompletado de direcciones en la búsqueda de radio responda con rapidez, WP-ImmoMakler coloca un pequeño script PHP (immomakler-autocomplete.php) en su sitio web. El script recibe la entrada del formulario de búsqueda, la reenvía desde el servidor a la Google Places API (New) y devuelve las sugerencias, sin cargar el núcleo completo de WordPress. De este modo, la lista de sugerencias es considerablemente más rápida y la clave de API de Google Maps permanece exclusivamente en el servidor sin enviarse al navegador.

Ubicación predeterminada: wp-content/cache/immomakler/fast-api/immomakler-autocomplete.php

Junto con el script se almacena un archivo .immomakler-autocomplete-secrets.php que contiene la clave de API de Google Maps, las URL de origen permitidas, así como los países configurados y el área de búsqueda. Ambos archivos se actualizan automáticamente cada vez que se modifican los ajustes correspondientes.

Ajuste: Ubicación del proxy Fast-API

En el backend de su sitio web (wp-admin) en WP-ImmoMakler → Ajustes → Google Maps encontrará el ajuste Autocompletado de direcciones Búsqueda de radio: Ubicación del proxy Fast-API. Las opciones disponibles son:

• wp-content (Predeterminado) – los archivos se almacenan en wp-content/cache/immomakler/fast-api/. Recomendado para todas las instalaciones nuevas.
• Directorio raíz – los archivos se almacenan directamente junto a wp-config.php. Alternativa para instalaciones en las que una extensión de seguridad como Wordfence o iThemes Security bloquea la ejecución de archivos PHP en wp-content/.

Si el autocompletado de direcciones en la búsqueda de radio no responde (lista de sugerencias vacía) y el plugin tampoco puede establecer conexión con el proxy Fast-API tras cargar la página, normalmente es porque una extensión de seguridad ha bloqueado la ejecución de archivos PHP en el directorio wp-content/. En ese caso, cambie el ajuste a Directorio raíz. La búsqueda de radio seguirá funcionando independientemente: WP-ImmoMakler utiliza las interfaces estándar de WordPress (REST API y admin-ajax) como opción de reserva automática, aunque estas vías son algo más lentas.

Redes multisitio

En las redes WordPress Multisitio, por razones de seguridad siempre se utiliza la ubicación wp-content y no se puede cambiar al directorio raíz. Cada sitio web de la red recibe su propia subcarpeta (p. ej. wp-content/cache/immomakler/fast-api/2/ para el sitio con el ID de blog 2), de modo que cada sitio puede funcionar con su propia clave de API de Google Maps, sus propias selecciones de países y su propia área de búsqueda. El directorio raíz es compartido por todos los sitios de la red, por lo que almacenar las credenciales allí haría que todos los sitios utilizaran la misma clave de API, lo que no es deseable en configuraciones multisitio con diferentes propietarios.

Mensajes de error en el backend

«Places API (New) no activada»

Si WP-ImmoMakler muestra el aviso «WP-ImmoMakler: Places API (New) no activada» en el backend de su sitio web (wp-admin), significa que la Places API (New) no está activada para su clave de API de servidor de Google en la Google Console, o no está seleccionada en las restricciones de API de la clave. En este caso, el autocompletado de direcciones en la búsqueda de radio no funcionará.

Solución:

1. Abra la Places API (New) en la Google Console y active la API para su proyecto.
2. Abra la clave de API de servidor afectada en Credenciales de API y añada la Places API (New) a la lista de APIs permitidas en «Restricciones de API».
3. Acceda a la página de ajustes en el backend de su sitio web (wp-admin) en WP-ImmoMakler → Integraciones → Servicios de geolocalización — WP-ImmoMakler prueba la clave automáticamente al cargar la página. Si la prueba fue exitosa, el aviso desaparece.

También puede interesarle

• Crear un ID de mapa de Google Maps
• Configurar la vista de mapa
• Configurar la búsqueda de radio
• Usar WP-ImmoMakler con Complianz