Con las API de Business Profile, puedes crear una plataforma para que tus comercios administren sus negocios en Google. En tu plataforma, puedes permitir que tus socios busquen fichas que coincidan con el nombre, la dirección y los datos de teléfono de su empresa. Pueden establecer la propiedad de una ubicación y, además, colocar con precisión la ubicación física de la empresa por latitud y longitud.
Antes de comenzar
Antes de usar las APIs de Business Profile, debes registrar tu aplicación y obtener credenciales de OAuth 2.0. Para obtener detalles sobre cómo comenzar a usar las APIs de Business Profile, consulta Configuración básica.
Cómo trabajar con datos de direcciones
Para trabajar con datos de direcciones y ubicación geográfica en tu plataforma, puedes usar dos conjuntos diferentes de APIs y recursos: las APIs de Business Profile y la API de Google Maps.
Recursos del Perfil de Negocio de uso frecuente
La API de GoogleLocations permite que el comercio vea con anticipación si ya se reclamó una ubicación en el Perfil de Negocio. De lo contrario, permite que el comercio solicite acceso de inmediato.
El objeto PostalAddress representa la dirección física de una empresa.
Recursos de Google Maps de uso frecuente
Los widgets de Places de la API de Maps JavaScript se usan de uso frecuente en los flujos de trabajo de los socios para crear un mapa interactivo. Además, las siguientes APIs de Maps también son útiles:
- Muestra predicciones de lugares con Place Autocomplete y Place Details. Para obtener detalles sobre los precios, consulta SKU: Autocomplete (incluido con Place Details), por sesión.
- Consulta información sobre lugares con Place Search. Para obtener detalles sobre los precios, consulta SKU: Find Place.
- Proporciona geocodificación y geocodificación inversa de direcciones con Geocoding. Para obtener detalles sobre los precios, consulta SKU: Geocoding.
Una o cero coincidencias
Cuando un socio busca fichas que coincidan con una ubicación, su objetivo es reducir los resultados de la búsqueda a una o cero coincidencias. Esto significa que la ubicación se ajusta a sus criterios de búsqueda o que aún no existe en el Perfil de Negocio, respectivamente.
Cuando haya una o ninguna coincidencia, usa el método accounts.locations.create para crear una ficha nueva o sigue la guía de GoogleLocations para reclamar la propiedad de la ficha existente. Si Google no puede geocodificar la dirección, la creación de la ubicación falla y la respuesta de la API incluye una solicitud de datos de LatLng. Para obtener información sobre cómo el comercio puede proporcionar sus datos de LatLng, consulta Ajuste manual de los datos de ubicación geográfica.
Una vez que se determinan las coordenadas de LatLng, se crea la ficha nueva.
Coincidencias parciales y múltiples
Cuando el propietario de una empresa o el equipo de operaciones del socio buscan fichas que coincidan con una ubicación, la información que escriben puede generar solo una coincidencia parcial o pueden recibir varias coincidencias para su búsqueda. Para reducir los resultados de la búsqueda a una o cero coincidencias, dos casos de uso de la API de Google Maps resuelven manualmente las coincidencias parciales y múltiples.
El usuario define mejor su búsqueda
Cuando un usuario de la plataforma del socio busca una ubicación y se encuentra con varias coincidencias parciales, puede resolver el problema de una de las siguientes maneras:
- Analiza las direcciones que coinciden parcialmente y selecciona la correcta.
- Editar o volver a escribir partes de la dirección para que sea más precisa y limitar los resultados a una o ninguna coincidencia
El usuario selecciona una o más coincidencias completas.
En algunos casos, es posible que varias ubicaciones coincidan por completo con la dirección de búsqueda del usuario. Por ejemplo, un usuario podría ingresar la siguiente dirección en una plataforma de socio:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Supongamos que se devuelven las siguientes respuestas, todas las cuales coinciden con la dirección proporcionada:
- Kasperson Printer Center, una ubicación no verificada.
- Bengo Seguro, una ubicación verificada.
- Garush Productions, una ubicación no verificada.
El usuario debe seleccionar manualmente la empresa coincidente. Para garantizar que los consumidores
reciban instrucciones sobre cómo llegar a la empresa, es posible que se deban ajustar los datos de latitud y longitud
(LatLng) de estas ubicaciones para proporcionar una mayor
precisión. Para obtener información sobre cómo los usuarios pueden ingresar su LatLng de forma manual, consulta
Ajuste manual de los datos de ubicación geográfica.
Ajuste manual de los datos de ubicación geográfica
Las empresas pueden agregar las coordenadas de latitud y longitud (LatLng) de su ubicación para aumentar la precisión de su ficha en el Perfil de Negocio. Es posible que las empresas nuevas no conozcan sus coordenadas de LatLng, por lo que pueden colocar un pin de forma manual con el widget de Places de la API de Maps JavaScript para establecer coordenadas de LatLng precisas.
LatLng, es necesario ajustar manualmente las coordenadas de cada
ubicación.Calidad de los resultados de la búsqueda
Los resultados de la búsqueda varían ampliamente según la exactitud de la dirección que se busca y la región geográfica. Las regiones en desarrollo suelen mostrar menos lugares de Maps y un cumplimiento inconsistente con los formatos de dirección de Google. Esto genera resultados de la búsqueda de menor calidad y una mayor necesidad de aplicar formato manual a las direcciones y usar la API de Google Maps.