Ubicaciones de Google

La API de GoogleLocations te permite ver con anticipación si se reclamó una ubicación en el Perfil de Negocio. De esta manera, si se reclamó la ubicación, puedes solicitar acceso de inmediato a ella. Además, si administras cuentas verificadas de forma masiva, puedes seleccionar con más precisión posibles coincidencias por adelantado y evitar la creación de ubicaciones duplicadas.

El extremo de la API muestra una URL que indica si ya se reclamó una ubicación. Si se reclamó, la misma URL te permite iniciar el proceso de solicitud de acceso.

En la siguiente imagen, se proporciona una descripción general del proceso para obtener la propiedad de una ubicación.

Figura 1. Diagrama de Swimlane de la propiedad de la ubicación del Perfil de Negocio

Los siguientes pasos te permiten usar la API de GoogleLocations:

  1. Recopilar datos de ubicación del comercio

  2. Llama al extremo googleLocations.search. Proporciona los datos de ubicación dentro del cuerpo de la llamada. De manera alternativa, puedes proporcionarla en una string de consulta, similar a lo que un usuario ingresaría en la Búsqueda o Maps. Por ejemplo, "Starbucks 5th ave NYC".

    La API muestra una lista de ubicaciones que pueden coincidir y, también, información sobre cada ubicación, como locationName y dirección.

  3. Selecciona la ubicación que coincida con tu ubicación. Si no hay coincidencias, llama a accounts.locations.create y ve al paso 5.

  4. Según el estado de requestAdminRightsUrl en la respuesta, realiza las siguientes acciones:

    1. Si requestAdminRightsUrl existe, otro usuario es propietario de la ficha. Dirige al comercio a la URL para iniciar una solicitud de acceso y propiedad de la ubicación existente en el Perfil de Negocio.
    2. Si requestAdminRightsUrl no existe, llama a accounts.locations.create y crea una ficha nueva que se verificará más tarde.
  5. Si creaste fichas nuevas como parte de este proceso, puedes usar las API de verificación para comenzar a verificarlas. Para obtener más información, consulta Administra la verificación.