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.

Configuración de ubicaciones

Para configurar ubicaciones, debes hacer lo siguiente:

Encontrar las ubicaciones

Las ubicaciones verificadas y publicadas son una característica estándar de los resultados de la Búsqueda de Google y de Maps. Las ubicaciones de este tipo tienen un propietario verificado. Para que la propiedad de una ubicación pase de una cuenta de Google a otra, es necesario enviar una solicitud de propiedad. Las ubicaciones no reclamadas que los Local Guides o la comunidad de usuarios crean se consideran no verificadas. Las plataformas crean y verifican nuevas ubicaciones.

Para configurar tus ubicaciones con la API de Google My Business, debes crear una plataforma para que tus comerciantes gestionen sus empresas en Google. En tu plataforma, puedes permitir a los usuarios que busquen fichas que concuerden con el nombre, la dirección y los datos telefónicos de su empresa.

La API GoogleLocations permite comprobar por adelantado si otro comerciante ya ha reclamado una ubicación en Google My Business. Si nadie la ha reclamado, puedes solicitar inmediatamente su propiedad. De lo contrario, deberás crear una ubicación nueva y verificarla.

Para obtener información adicional, consulta la guía sobre la búsqueda de fichas de empresa que coincidan.

Resultados de búsquedas de ubicaciones

Si estás buscando fichas de ubicación y quieres reclamar una ubicación, debes seguir estos pasos:

  1. Recoge datos de la ubicación, como el nombre de la empresa, su dirección y la categoría del comercio.
  2. Haz una llamada al punto de conexión googleLocations.search y proporciona los datos de ubicación en el cuerpo de la solicitud de la llamada. También puedes buscar una cadena de consulta similar a la que escriben los usuarios en la Búsqueda o en Maps. Por ejemplo, "Starbucks Gran Vía Madrid" es una cadena de consulta.
  3. La API devuelve una lista con posibles coincidencias de la ubicación e información sobre cada una, como el valor de locationName y la dirección.

    Cuando la API devuelva la lista, tienes dos opciones:

    1. Si no hay coincidencias, utiliza un ID de sitio vacío para crear una ubicación y verificarla.
    2. Si hay una o varias coincidencias, pide al propietario de la empresa que seleccione la que más concuerde.

      Si hay un valor de requestAdminRightsUrl, el propietario debe iniciar sesión en su cuenta de Google y hacer clic en el enlace para iniciar el proceso de solicitud de la propiedad.

      Si no hay un valor de requestAdminRightsUrl, crea una ubicación con el ID de sitio que se ha devuelto y verifícala.

Solicitudes de propiedad

La confianza entre los comerciantes, una comunicación abierta y las cuentas de Google son fundamentales en el proceso de reclamación de la propiedad de ubicaciones. Hay casos en los que las reclamaciones de propiedad están parcialmente automatizadas y se necesita que la persona que solicita la propiedad de la empresa cierre sesión en la plataforma, inicie sesión en su cuenta de Google y haga clic en botones o enlaces de Google My Business.

Una empresa puede tardar hasta 7 días en transferirse. Cuando termina la transferencia, el comerciante debe iniciar sesión y completar manualmente el proceso de reclamación de propiedad.

Es posible que quien sea propietario de la empresa en ese momento rechace la solicitud y que la persona que ha solicitado la propiedad no actúe como se comunica en el correo electrónico de notificación de Google. Si se rechaza la reclamación de propiedad, el propietario que la ha solicitado puede apelar.

Para minimizar el abandono, te recomendamos que implementes un proceso para hacer un seguimiento de las solicitudes de propiedad. Puede ser automático o manual, poniéndote en contacto con el solicitante de la propiedad unos 7 a 10 días después de que haya iniciado la reclamación.

Resumen del proceso de asignación de la propiedad de ubicaciones

En el siguiente diagrama se muestra el proceso de asignación de la propiedad de ubicaciones:

Diagrama de flujo del proceso de asignación de la propiedad de ubicaciones
Figura 1. Diagrama en el que se resume el proceso de asignación de la propiedad de ubicaciones

Duplicados

Si añades una ubicación que ya se haya verificado en Google My Business, no aparecerá en Google Maps y se marcará como "Ubicación duplicada" en tu cuenta. Solo se permite una ubicación verificada. Las ubicaciones duplicadas no se pueden verificar ni publicar. No es necesario eliminar manualmente los duplicados.

Las reseñas se suelen migrar a la nueva ubicación verificada. Consulta cómo pasar reseñas de una ficha a otra.

Crear las ubicaciones

En Google Maps, los sitios se representan mediante IDs de sitio, y las cuentas y ubicaciones de Google My Business se representan mediante IDs de cuenta y de ubicación.

Ubicaciones y sitios

Cuando creas una ubicación, se asocia a un sitio de Google Maps. Esto también ocurre con las empresas de servicios locales, aunque la dirección no se puede ver públicamente.

Te recomendamos hacer lo siguiente cuando crees ubicaciones:

  • Incluye un solo ID de sitio. En la respuesta de error de la API se especifica si se requieren coordenadas de latitud y longitud.
  • Si eres el propietario de la empresa y estás gestionando el proceso, los widgets de Places y la API Geocoding, ambos de la API JavaScript de Google Maps, te ofrecen una experiencia óptima y que te resultará familiar para localizar con precisión la empresa situando un marcador en el mapa.
  • Es posible que en las zonas de nueva construcción y las regiones de gran crecimiento se requieran coordenadas de latitud y longitud. Normalmente, Google Maps determina los ID de sitio, las direcciones y los datos de latitud y longitud.

Las ubicaciones y los sitios tienen una relación de muchos a muchos. Puede haber varias ubicaciones asociadas a un mismo ID de sitio. Por ejemplo, los locales de un centro comercial o los departamentos de un hospital son ubicaciones. De la misma manera, puede haber varios ID de sitio asociados a una misma ubicación. Consulta más información en las Directrices para dar a conocer empresas en Google. Las directrices se aplican a todos los usuarios.

IDs de sitio de Google Maps

Los ID de sitio de Google Maps no son únicos y pueden cambiar. Consulta la guía sobre IDs de sitio de Maps para saber cómo almacenarlos en caché, guardarlos y gestionarlos de forma segura, y cómo evaluar su uso.

Consulta la guía Utilizar mapas de interiores para ver planos de planta para saber cómo crear y actualizar dichos planos.

Credenciales de OAuth

Cuando crees una ubicación, utiliza las credenciales de OAuth del propietario de la empresa correspondiente siempre que sea posible. Así, la cuenta de Google del propietario se asignará como propietario principal para gestionar las invitaciones y cambiar la propiedad de la ubicación, pero sin utilizar el nombre del propietario.

Objetos de la API y estado de las fichas

El objeto Location de la API encapsula toda la información asociada a una ubicación. El objeto LocationState representa el estado actual de una ubicación, como "Pendiente de verificación", "Duplicada" o "Publicada".

Consulta las descripciones de todos los estados posibles que puede tener una ficha en el artículo Acerca del estado del perfil de empresa.

Categorías y atributos

Te recomendamos que, cuando crees o actualices ubicaciones, accedas a las listas actualizadas de categorías y atributos, y selecciones las opciones que correspondan a tus ubicaciones. Las listas disponibles pueden cambiar en cualquier momento.

Utiliza los métodos de la API categories.list y attributes.list para obtener una actualización precisa de la lista de fechas de Google. Las opciones disponibles están localizadas y son distintas, en función del idioma y la región. La API utiliza códigos de idioma BCP 47 y códigos de país ISO 3166-1 alfa-2 para describir los idiomas y las regiones.

Direcciones postales

Las direcciones deben cumplir los requisitos de región e idioma de direcciones postales de Google My Business. Estos requisitos suelen ser más exigentes que los de las empresas que la comunidad ha creado en Google Maps y que no están verificadas. Los Local Guides y los usuarios de Maps y la Búsqueda pueden escribir direcciones de empresa y detalles en ubicaciones no reclamadas. Esta información suele escribirse en lenguaje coloquial y formatos no estándar.

El proyecto de software libre libaddressinput te puede ayudar a que tu plataforma cumpla estos requisitos.

Los comercios, equipos de operaciones y terceros pueden contribuir a garantizar la precisión.

Cuando hagas una llamada a accounts.locations.create con el parámetro validateOnly=true definido, te recomendamos que te asegures de que los campos obligatorios estén presentes y que las direcciones postales tengan el formato correcto.

Geocodificación

La geocodificación convierte las direcciones en coordenadas geográficas que puedes utilizar para situar marcadores en un mapa o para posicionarlo.

Las coordenadas de latitud y longitud se usan para definir ubicaciones físicas en Maps con geocodificación, en la API Places y también se utilizan con datos de terceros.

Los comerciantes, equipos de operaciones y terceros pueden ayudar a garantizar que las direcciones estén asociadas correctamente a un sitio, que representa un par de coordenadas de latitud y longitud.

Actualizaciones de ubicaciones

Por lo general, los propietarios y administradores de las ubicaciones son quienes suelen modificarlas, pero también puede que lo hagan usuarios de Internet, Local Guides o Google. En el artículo Cómo obtiene y utiliza Google la información de las fichas de empresa se explica de qué manera se gestionan las actualizaciones y cómo se muestran en Google Maps y en los resultados de búsqueda.

Los cambios se suelen aceptar, pero no se garantiza que siempre sea así. En los artículos Qué sucede con los cambios y Gestionar las actualizaciones de Google del Centro de Ayuda se describe el proceso de revisión y publicación de forma más detallada.

El método accounts.locations.getGoogleUpdated devuelve información detallada sobre las modificaciones que Google ha hecho a las ubicaciones.

Verificar ubicaciones

Mediante el proceso de verificación de ubicaciones, estas se publican en Google Maps y en la Búsqueda. Las empresas no verificadas no se pueden ver públicamente. También se confirma la identidad del propietario de la ubicación en cuestión, y dicha ubicación se vincula con una cuenta de Google. Puede que el propietario tenga que escribir un código PIN para verificar la ubicación.

Verificación basada en plataformas

Las plataformas de partners pueden verificar ubicaciones sin que los usuarios tengan que salir de ellas. La plataforma en cuestión envía una consulta a los métodos de verificación disponibles, como a través de correo electrónico, SMS, teléfono o correo postal, o de manera instantánea y en bloque. A continuación, si es necesario, solicita al propietario de la empresa que elija el método que prefiera. Los servicios de Google facilitan el código de verificación de PIN al propietario de la empresa. Si la verificación automática está disponible, el propietario no tiene que hacer nada para verificar su empresa.

En el siguiente diagrama se muestra el proceso de verificación basado en plataformas:

Diagrama del proceso de verificación basada en plataformas.
Figura 2. Diagrama en el que se resume la verificación basada en plataformas

Prácticas recomendadas

La verificación puede tardar varios días en completarse. Debes utilizar el método "poll" para consultar el estado de la verificación. Si devuelve una lista de métodos de verificación vacía, utiliza un patrón de reintento.

Los cambios en los nombres, las direcciones y las categorías de empresas pueden volver a desencadenar el proceso de verificación. Haz este tipo de cambios antes de iniciar dicho proceso.

Sigue estas prácticas recomendadas para que los comercios consigan las mayores tasas de conversión posibles:

  • Mide la frecuencia con la que se presenta cada método de verificación.
  • Mide los porcentajes de abandono del proceso de conversión en los cuadros de diálogo y en cada paso.
  • Si la ubicación no se verifica, haz un seguimiento con el comerciante correspondiente.

Cadenas y marcas

A las cadenas y marcas se les exigen requisitos diferentes para cumplir con los objetivos de las franquicias, los franquiciados y los partners. Hay un equipo de asistencia y relaciones entre partners que se encarga de gestionar la verificación de las ubicaciones de las cadenas.

Consulta más información sobre cómo registrar, crear y verificar ubicaciones de cadenas en la guía Solicitar una verificación en bloque para más de 10 ubicaciones.

Una vez verificadas, las ubicaciones publicadas de cadenas se pueden gestionar con la API de Google My Business de la misma manera en que se gestionan otras ubicaciones, con algunas excepciones. Por ejemplo, los administradores del sitio se gestionan de forma diferente y ellos mismos se pueden añadir a ubicaciones de franquicias. Consulta más información en Propietarios y administradores de fichas.

Vinculación

Para que tu ubicación se pueda encontrar, puedes vincularla con Google Ads, publicaciones o reseñas.

Consulta información sobre cómo sincronizar tu cuenta de Google My Business con la de Google Ads en la guía sobre integración con Google Ads y en la entrada del blog para desarrolladores de Google Ads sobre el uso de la API de Google My Business para gestionar extensiones de ubicación.

Consulta el sitio web para desarrolladores de la API de AdWords o el foro del API de AdWords para obtener más información sobre dicha API.

El valor de storeCode de la ubicación de Google My Business debe ser el mismo que el del feed del inventario de productos locales de Google Ads.

Usa el formato siguiente para crear un enlace profundo:

https://business.google.com/{edit|posts|reviews}/l/u{location_id}

La API de Google My Business devuelve IDs de ubicación y de cuenta no ofuscados. La interfaz web de Google My Business utiliza una combinación de IDs ofuscados y no ofuscados.

Se aplican restricciones de acceso y de inicio de sesión de usuario. Por ejemplo, el usuario de la cuenta de Google debe tener derechos de propietario o administrador para editar una ubicación.

Datos

La API ofrece varios datos y métricas de ubicación.

Puedes consultar y analizar las métricas siguientes de cada ubicación:

  • La frecuencia con la que se ha mostrado el recurso cuando se ha buscado la ubicación directamente
  • La frecuencia con la que se ha mostrado el recurso como resultado de una búsqueda por categoría, por ejemplo, al buscar restaurantes
  • El número de veces que se ha visto el recurso en la Búsqueda de Google
  • El número de veces que se ha visto la publicación local en la Búsqueda de Google
  • El número de veces que se ha visto el recurso en Google Maps
  • El número de veces que se ha hecho clic en el sitio web
  • El número de veces que se ha hecho clic en el número de teléfono
  • El número de veces que se han solicitado las indicaciones para llegar en coche
  • El número de veces que se ha hecho clic en el botón de llamada a la acción
  • La cantidad de visualizaciones de fotos que ha subido el comerciante
  • El número total de fotos publicadas actualmente que ha subido el comerciante

Consulta más información en la guía Obtener datos sobre la ubicación.