Atención: se ha lanzado la versión 4.7 de la API. Consulta el registro de cambios. Las cadenas aún pueden hacer publicaciones relacionadas con el COVID‑19.

Buscar fichas que coincidan

Con la API de Google My Business, puedes crear una plataforma para que tus comerciantes gestionen sus empresas en Google. En dicha plataforma, puedes permitir que tus clientes busquen fichas cuyos nombres de negocio, direcciones y datos telefónicos coincidan con los de su empresa. 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 la API de Google My Business, debes registrar tu aplicación y obtener credenciales de OAuth 2.0. Consulta información detallada sobre cómo empezar a usar la API de Google My Business en la guía 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: la API de Google My Business y la API de Maps.

Recursos de Google My Business utilizados habitualmente

La API GoogleLocations permite a los comerciantes comprobar por adelantado si una ubicación ya se ha reclamado en Google My Business. Si nadie la ha reclamado, permite a los comerciantes 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 API de Maps también resultan útiles:

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. Si obtiene una coincidencia, la ubicación devuelta cumple sus criterios de búsqueda. Si no obtiene ninguna, se debe a que la ubicación aún no existe en Google My Business.

Si no se devuelve ninguna coincidencia, se debe usar el método accounts.locations.create para crear la ficha. Si se devuelve 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 totales

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 varias coincidencias parciales o totales. 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 varias coincidencias parciales o totales, acotes los resultados a una coincidencia o ninguna.

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.
Un usuario obtiene varias coincidencias parciales al buscar su dirección.

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

Los comerciantes pueden añadir las coordenadas de latitud y longitud (LatLng) de sus empresas para mejorar la precisión de su ficha de Google My Business. Es posible que los comerciantes nuevos no conozcan sus coordenadas LatLng. En ese caso, pueden situar manualmente una chincheta con el widget Places de la API JavaScript de Maps para definir las coordenadas LatLng de manera precisa.

Una dirección devuelve tres ubicaciones en una distancia de 457 metros. Para asociar de forma precisa la dirección de la empresa con sus coordenadas LatLng, hay que ajustar manualmente las coordenadas de su ubicació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.