Descubrimiento local con Nearby Search

En este documento, verás cómo usar la API de Nearby Search (nueva) para crear una solución simple y rentable

de descubrimiento local.

Una experiencia de descubrimiento local muestra a los usuarios lugares de interés clave cerca de una ubicación que especifiques cuando busquen un hotel o una propiedad inmobiliaria. Suele consistir 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 funciones 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 de 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 que los usuarios seleccionen un lugar y actualicen 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 de caminata para que los usuarios comprendan rápidamente si se ajusta a sus necesidades.

Arquitectura de referencia

alt_text

Descubrimiento local

Existen 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 ejemplo dividida en pasos, junto con una descripción de la implementación técnica con las APIs de Google Maps Platform.

1. Búsqueda por ubicación con AutocompleteBuscar ubicación

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

ejemplo de autocompletado

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

  • Clasificación por popularidad (resultados más relevantes) o Clasificación por distancia.
  • includedTypes, excludedTypes; si eres un hotel, puedes excluir el tipo "lodging" y, luego, incluir solo los tipos adecuados, p. ej.: "restaurant, cafe, park, tourist_attraction".
  • Aprovecha includedPrimaryTypes y 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 que no haya resultados, amplía el tamaño del círculo o rectángulo antes de mostrar los resultados.

lugares cercanos de muestra

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

  • Básico (displayName, types, openingHours, formattedAddress)
  • Contacto (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Preferido (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 un bien inmueble 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 Dynamic Maps y la API de Directions

  • Tramo y pasos actualizados mediante una consulta a la API de Directions. * Usa el tiempo en la siguiente sección.

instrucciones de ejemplo

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

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

    Hora: 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 versión preliminar sin restricciones de la API de Nearby Search (nueva), tendrás que consultar Place Details con place.id para obtener photo_reference y, luego, consultar una por una en tu experiencia.

detalles de lugares

Recuento de consultas y costo asociado

Conclusión

Una experiencia de descubrimiento local es una forma eficaz de ofrecer valor a los usuarios. Esta implementación de demostración tiene muchas funciones que probablemente incluirás cuando crees una experiencia de este tipo en Google Maps Platform con capacidades especiales de la API de Nearby Search (nueva) .

Próximos pasos

Lecturas adicionales sugeridas:

Colaboradores

Autores principales:

Thomas Anglaret | Ingeniero de soluciones de Google Maps Platform