Con las API del Perfil de Negocio, puedes crear una plataforma para que tus comercios administren sus empresas 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 ubicar con precisión la ubicación física de la empresa por latitud y longitud.
Antes de comenzar
Antes de utilizar las API del Perfil de Negocio, debes registrar tu aplicación y obtener las credenciales de OAuth 2.0. Si deseas obtener detalles para comenzar a usar las APIs del Perfil de Negocio, consulta Configuración básica.
Cómo trabajar con datos de direcciones
Para trabajar con datos de dirección y ubicación geográfica en tu plataforma, puedes usar dos conjuntos diferentes de APIs y recursos: las APIs del Perfil de Negocio y la API de Maps.
Recursos de uso frecuente del Perfil de Negocio
La API de GoogleLocations
le permite
al comercio ver con anticipación si ya se reclamó una ubicación en el
Perfil de Negocio. De lo contrario, el comercio puede solicitar acceso de inmediato.
El objeto PostalAddress
representa la dirección física de una empresa.
Recursos de Google Maps de uso general
Por lo general, los widgets de Places de Maps JavaScript se usan en flujos de trabajo de socios para crear un mapa interactivo. Además, las siguientes APIs de Google Maps también son útiles:
- Muestra predicciones de lugares con Place Autocomplete y Place Details. Para conocer los detalles de precios, consulta SKU: Autocomplete (incluido con Place Details), por sesión.
- Consulta información de lugares con Place Search. Para obtener más información sobre los precios, consulta SKU: Find Place.
- Brinda la geocodificación y la geocodificación inversa de las direcciones con Geocoding. Para obtener detalles sobre los precios, consulta SKU: Geocoding.
Una o ninguna coincidencia
Cuando un socio busca fichas coincidentes para una ubicación, su objetivo es reducir los resultados de la búsqueda a una o ninguna coincidencia. Esto significa que la ubicación se ajusta a sus criterios de búsqueda o 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 el ajuste manual de datos de ubicación geográfica.
Una vez que se determinan las coordenadas 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 escriban puede generar solo una coincidencia parcial o recibir varias coincidencias con su búsqueda. Para limitar los resultados de la búsqueda a una o ninguna coincidencia, las coincidencias parciales o múltiples se resuelven de forma manual mediante dos casos de uso de la API de Google Maps.
El usuario define mejor su búsqueda
Cuando un usuario de la plataforma asociada busca una ubicación y se encuentra con varias coincidencias parciales, puede resolver el problema de una de las siguientes maneras:
- Analiza las direcciones con coincidencia parcial y selecciona la correcta.
- Edita o vuelve a escribir partes de la dirección para ser más precisas y acotar sus resultados a una o ninguna coincidencia.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=7&hl=es-419)
El usuario selecciona una o más coincidencias completas
En algunos casos, es posible que varias ubicaciones coincidan completamente con la dirección de búsqueda del usuario. Por ejemplo, un usuario podría ingresar la siguiente dirección en una plataforma asociada:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Supongamos que se muestran las siguientes respuestas, que coinciden con la dirección proporcionada:
- Kasperson Printer Center, una ubicación sin verificar.
- Bengo Seguro, una ubicación verificada.
- Garush Productions, una ubicación no verificada
El usuario deberá seleccionar manualmente la empresa que coincida. Para garantizar que los consumidores reciban instrucciones precisas sobre cómo llegar a la empresa, es posible que sea necesario ajustar los datos de latitud y longitud (LatLng
) de estas ubicaciones para brindar 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 negocio 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 marcador manualmente con el widget de Places de Maps JavaScript para establecer coordenadas LatLng
precisas.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=7&hl=es-419)
LatLng
, debes realizar un ajuste manual de 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 según la región geográfica. Las regiones en desarrollo suelen mostrar menos lugares en Maps y un cumplimiento incoherente con los formatos de direcciones de Google. Esto genera resultados de la búsqueda de menor calidad y una mayor necesidad de formato manual de direcciones y de uso de la API de Google Maps.