Con las APIs de 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 usar las APIs de Perfil de Negocio, debes registrar tu aplicación y obtener credenciales de OAuth 2.0. Para obtener información sobre cómo comenzar a usar las APIs de Perfil de Negocio, 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 Perfil de Negocio y la API de Maps.
Recursos del Perfil de Negocio de uso general
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 a él de inmediato.
El objeto PostalAddress representa la dirección física de una empresa.
Recursos de Google Maps de uso general
Los widgets de Places de Maps JavaScript se usan comúnmente en flujos de trabajo de 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 limitar 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.
Si hay una o ninguna coincidencia, usa el método accounts.locations.create para crear una ficha nueva o sigue las instrucciones de la guía 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 geolocalización.
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 busca fichas que coincidan con una ubicación, la información que escribe puede generar solo una coincidencia parcial o varias coincidencias con su búsqueda. Para limitar los resultados de la búsqueda a una o cero coincidencias, dos casos de uso de la API de Maps resuelven manualmente las coincidencias parciales y múltiples.
El usuario define mejor su búsqueda
Cuando un usuario de la plataforma de socios 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.
- Edita o vuelve a escribir partes de la dirección para que sea más precisa y limita 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 puede ingresar la siguiente dirección en una plataforma de socios:
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 no verificada.
- Bengo Seguro, una ubicación verificada
- Garush Productions, una ubicación no verificada.
El usuario debe seleccionar manualmente la empresa que coincide. Para garantizar que se proporcionen instrucciones precisas a los consumidores para llegar a la empresa, es posible que debas 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 geolocalización.
Ajuste manual de los datos de ubicación geográfica
Las empresas pueden agregar las coordenadas de latitud y longitud (LatLng) de su empresa para aumentar la precisión de su ficha en el Perfil de Negocio. Es posible que las empresas nuevas no conozcan sus coordenadas LatLng, por lo que, en su lugar, pueden colocar un pin de forma manual con el widget de Places de Maps JavaScript para establecer coordenadas 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 mucho según la precisión 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 direcciones de Google. Esto genera resultados de la búsqueda de menor calidad y una mayor necesidad de usar la API de Maps y de aplicar el formato de direcciones de forma manual.