Mejora el descubrimiento local con la API de Nearby Search (nuevo)

En este documento, verás cómo usar la API de Nearby Search (nueva) para crear una experiencia de

descubrimiento local simple y rentable.

Una experiencia de descubrimiento local muestra a los usuarios lugares de interés clave cerca de una ubicación que especificas cuando buscan un hotel o una propiedad inmobiliaria. Por lo general, consiste en un mapa interactivo, con un panel adicional que contiene un selector de lugares y una galería de fotos. Se te presentarán diferentes productos y capacidades de Google Maps Platform para mejorar la experiencia con interactividad.

Ejemplo de descubrimiento local

Casos de uso

Ahora, veamos qué elementos de la integración del descubrimiento local generan valor para el usuario:

  • Descubrimiento : Brinda a los usuarios una descripción general de lo que hay alrededor de una sola ubicación mostrando lugares relevantes de varios tipos.

  • Interactividad : Permite a los usuarios seleccionar un lugar y actualizar los datos de forma dinámica

    en relación con ese lugar.

  • Visualización - Proporciona opiniones y fotos de lugares

    y el tiempo y la distancia a pie para que los usuarios comprendan rápidamente si se ajusta a sus necesidades.

Arquitectura de referencia

alt_text

Descubrimiento local

Hay muchas formas de crear una experiencia de descubrimiento local. La siguiente integración es un ejemplo personalizado de una experiencia del usuario que aprovecha las APIs conocidas de Google Maps Platform, así como algunas funciones nuevas y emocionantes. Si deseas tener un enfoque basado en plantillas para el descubrimiento local, puedes usar componentes web.

Aplicación de muestra

Explicación de ejemplo

En la siguiente tabla, encontrarás la aplicación de muestra dividida en pasos, junto con una descripción de la implementación técnica con las APIs de Google Maps Platform.

1. Búsqueda de ubicación con AutocompleteSearch location

  • Carga la API de Maps JavaScript.
  • Consulta Places Autocomplete o elige la ubicación en el mapa.

Ejemplo de autocompletado

2. Muestra puntos de interés locales con la API de Nearby Search (nueva)

  • Clasificación de popularidad (resultados más relevantes) o clasificación de distancia.
  • includedTypes, excludedTypes; si tienes un hotel, puedes excluir el tipo "alojamiento" e incluir solo los tipos adecuados, es decir, "restaurante, cafetería, parque, atracción turística".
  • Aprovecha includedPrimaryTypes, excludedPrimaryTypes para tener aún más control sobre los resultados.
  • `locationRestriction para evitar una cantidad insuficiente de resultados o lugares demasiado alejados; en caso de CERO resultados, amplía el tamaño del círculo o rectángulo antes de mostrar los resultados.

Ejemplo de lugares cercanos

Ejemplo de consulta cuando se reserva un hotel con los campos de datos solicitados:

  • Básico (displayName, types, openingHours, formattedAddress)
  • Contacto (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Preferidos (reviews, priceLevel, userRatingCount)
 { "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

Ejemplo de consulta cuando se busca una propiedad inmobiliaria con los campos de datos solicitados:

  • Básico (displayName, types, openingHours, formattedAddress)
 { "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

3. Agrega interactividad con la API de Directions y Maps dinámicos

  • Consulta la API de Directions para obtener tramos y pasos actualizados. * Usa el tiempo en la siguiente sección.

Instrucciones de muestra

4. Muestra información detallada del lugar cuando se interactúa con él

  1. Descripción: displayName, types, rating, userRatingCount, priceLevel.

    Tiempo: Proviene de la consulta anterior a la API de Directions.

  2. Opiniones: reviews[i].author, reviews[i].rating,reviews[i].text.

  3. Imágenes: Durante la vista previa sin restricciones de la API de Nearby Search (nueva), deberás consultar los detalles de Places con place.id para obtener photo_reference y, luego, consultar una a la vez en tu experiencia.

detalles de lugares

Cantidad de consultas y costo asociado

Conclusión

Una experiencia de descubrimiento local es una forma eficaz de generar valor para el usuario. Esta implementación de demostración tiene muchas funciones que es probable que incluyas cuando crees una experiencia de este tipo en Google Maps Platform con capacidades especiales de la API de Nearby Search (nueva) .

Próximos pasos

Lectura adicional sugerida:

Colaboradores

Autores principales:

Thomas Anglaret | Ingeniero de soluciones de Google Maps Platform