Con las APIs de Perfil de Empresa, puedes crear una plataforma para que tus comerciantes gestionen sus empresas en Google. En esa plataforma, tus partners pueden buscar fichas cuyos nombres, direcciones y datos telefónicos coincidan con los de su empresa. Además, pueden indicar que son propietarios de una ubicación y definir con precisión la latitud y la longitud del lugar en el que se encuentra.
Antes de empezar
Para usar las APIs de Perfil de Empresa, debes registrar tu aplicación y obtener credenciales de OAuth 2.0. Para saber cómo empezar a usar las APIs de Perfil de Empresa, consulta el artículo Configuración básica.
Cómo usar datos de direcciones
Para usar datos de direcciones y de geolocalización en tu plataforma, puedes utilizar dos conjuntos distintos de APIs y recursos: las APIs de Perfil de Empresa y la API de Maps.
Recursos de Perfil de Empresa utilizados habitualmente
La API GoogleLocations
permite al comerciante comprobar por adelantado si una ubicación ya se ha reclamado en Perfil de Empresa. Si nadie la ha reclamado, el comerciante puede solicitar acceso a ella inmediatamente.
El objeto PostalAddress
representa la dirección física de una empresa.
Recursos de Google Maps utilizados habitualmente
Los widgets de Places de la API JavaScript de Maps se suelen utilizar en los flujos de trabajo de los partners para crear mapas interactivos. Además, las siguientes APIs de Maps también resultan útiles:
- Consulta predicciones de sitios enviando una solicitud al servicio Place Autocomplete y a Place Details. Accede a SKU: Autocomplete (incluido con Places Details), por sesión para obtener más información sobre los precios.
- Consulta información sobre sitios con Place Search. Accede a SKU: Find Place para obtener más información sobre los precios.
- Proporciona la geocodificación estándar y la inversa de las direcciones con Geocoding. Accede a SKU: Geocoding para obtener más información sobre los precios.
Una coincidencia o ninguna
Cuando un partner busca fichas que coincidan con una ubicación, su objetivo es acotar sus resultados de búsqueda a una coincidencia o a ninguna. Esto significa que, o bien la búsqueda devuelve una ubicación que coincide con los criterios especificados, o bien no devuelve ningún resultado porque la ubicación todavía no existe en Perfil de Empresa.
Si no se obtiene ninguna coincidencia, se debe usar el método accounts.locations.create
para crear la ficha. Si se obtiene una coincidencia, se deben seguir los pasos que se indican en la guía sobre GoogleLocations
para reclamar la propiedad de esa ficha. Si Google no puede geocodificar la dirección, no crea la ubicación y la respuesta de la API incluye una solicitud de datos LatLng
. Consulta cómo puede proporcionar el comerciante sus datos de LatLng
en Ajuste manual de los datos de geolocalización.
Una vez que se determinen las coordenadas LatLng
, se creará la ficha.
Coincidencias parciales y múltiples
Cuando el propietario de una empresa o el equipo de operaciones del partner buscan fichas para encontrar coincidencias con su ubicación, puede que con la información que escriben en la consulta se devuelvan solo una coincidencia parcial o varias coincidencias. A continuación, se explican los casos prácticos que se deben aplicar con la API de Maps para que, si una búsqueda devuelve coincidencias parciales o múltiples coincidencias, acotes los resultados a una coincidencia o ninguna.
Acotar mejor la búsqueda
Cuando un usuario de la plataforma para partners busca una ubicación y la búsqueda devuelve varias coincidencias parciales, puede resolver el problema de una de las siguientes formas:
- Analizando las direcciones y seleccionando la correcta.
- Editando o volviendo a escribir partes de la dirección para que sea más precisa y acotar sus resultados a una coincidencia o ninguna.
Seleccionar una o más de las coincidencias totales
En algunos casos, la búsqueda puede devolver varias ubicaciones que coincidan totalmente con la ubicación del usuario. Supongamos que un comerciante busca la dirección siguiente en una plataforma para partners:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Supongamos que se devuelven los resultados siguientes, que coinciden con la dirección especificada:
- Kasperson Printer Center, una ubicación sin verificar.
- Bengo Seguro, una ubicación verificada.
- Garush Productions, una ubicación sin verificar.
El comerciante debe seleccionar manualmente el resultado que corresponda a su empresa. Para asegurarse de que los usuarios reciben indicaciones precisas para llegar al establecimiento, es posible que los datos de latitud y longitud (LatLng
) de la ubicación se tengan que ajustar. Consulta cómo puede proporcionar el comerciante sus datos de LatLng
en Ajuste manual de los datos de geolocalización.
Ajuste manual de los datos de geolocalización
Las empresas pueden añadir las coordenadas de latitud y longitud (LatLng
) de su ubicación para mejorar la precisión de su ficha de Perfil de Empresa. Algunas empresas nuevas podrían no saber cuáles son sus coordenadas LatLng
. En ese caso, pueden colocar manualmente un marcador con el widget Places de la API JavaScript de Maps para definir las coordenadas LatLng
con precisión.
Calidad de los resultados de búsqueda
Los resultados de búsqueda obtenidos varían en función de la precisión de la dirección que se esté buscando y la región geográfica. Por lo general, las regiones en desarrollo tienen menos sitios definidos en Maps y sus formatos de dirección no cumplen de manera coherente los requisitos de Google. Por eso, los resultados de búsqueda son de menor calidad y es necesario ajustar manualmente el formato de dirección y usar la API de Maps.