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 compilar una solución simple y rentable

experiencia de descubrimiento local.

La 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. A menudo, 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

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 conocidas APIs 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 de ubicación con AutocompleteSearch location

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

Autocompletado de muestra

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

  • Clasificación por popularidad (resultados más pertinentes) o clasificación por distancia
  • includedTypes, excludedTypes; si tienes un hotel, puedes excluir el tipo “alojamiento” e incluir solo los tipos adecuados, p. ej., “restaurante, cafetería, parque, atracción turística”.
  • Aproveche includedPrimaryTypes, excludedPrimaryTypes para un mayor control sobre los resultados.
  • `locationRestriction para evitar un número insuficiente de resultados o lugares demasiado lejanos; en caso de CERO resultados, amplíe el tamaño del círculo / rectángulo antes de mostrar los resultados.

muestra lugares cercanos

Ejemplo de búsqueda 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 búsqueda cuando se busca una propiedad inmobiliaria con los campos de datos solicitados:

  • Básica (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. Añade interactividad con la API de mapas y direcciones dinámicas

  • Tramos y pasos actualizados a través de consultas a la API de Directions * Tiempo de uso en la siguiente sección

instrucciones de muestra

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 de 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 (nuevo), deberás consultar Place Details con place.id para obtener photo_reference y, luego, consultar una a la vez en tu experiencia.

detalles de lugares

Recuento de consultas y costo asociado

Conclusión

Una experiencia de descubrimiento local es una forma eficaz de brindar 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 (nuevo) .

Próximos pasos

Lecturas adicionales sugeridas:

Colaboradores

Autores principales:

Thomas Anglaret | Ingeniero de soluciones de Google Maps Platform