Ya está disponible la API de Q&A. Es obligatorio llevar a cabo la migración. Consulta nuestro programa de desactivación para obtener más información sobre los puntos finales obsoletos.
La versión 1.1 de la API Notifications ya está disponible. Consulta el registro de cambios para obtener más información. También puedes registrarte en nuestra lista de distribución para recibir las novedades.

Buscar fichas que coincidan

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

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:

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.

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

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.

Una dirección devuelve tres ubicaciones a 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.