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

En este documento, aprenderás a usar la API de Nearby Search (nuevo) a crear una solución sencilla 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 un bien raíz. A menudo, consta de 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 la interactividad.

descubrimiento local de muestra

Casos de uso

Veamos qué elementos de la integración de descubrimiento local impulsan valor:

  • Descubrimiento: Ofrezca a los usuarios una descripción general de los alrededores de una ubicación. muestran lugares relevantes de diversos 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 la distancia y el tiempo de caminata para que los usuarios entiendan rápidamente si se ajusta 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 Web Components.

Aplicación de muestra

Explicación de ejemplo

En la tabla que aparece debajo, encontrarás la aplicación de ejemplo dividida en pasos junto con una descripción de la implementación técnica con Google Maps APIs de Google.

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

  • Carga la API de Maps JavaScript.
  • Consulta Place Autocomplete o elige una 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 ranking por distancia
  • includedTypes, excludedTypes; si tienes un hotel, puedes excluir el tipo “alojamiento” y solo incluir los tipos adecuados, p. ej., “restaurante, cafetería, parque, atracción turística”.
  • Aproveche includedPrimaryTypes, excludedPrimaryTypes para obtener 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 el rectángulo antes de mostrar los resultados.

muestra 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)
  • 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 raíz 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. Agrega interactividad con la API de Maps dinámicos y de Direcciones

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

ejemplos de instrucciones sobre cómo llegar

4. Mostrar información detallada del lugar luego de la interacción

  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 y reviews[i].text.

  3. Imágenes: Durante la vista previa sin restricciones de la API de Nearby Search (nueva), deberá consultar Lugares Detalles con place.id para obtener photo_reference para hacer consultas una por una, según tu experiencia

detalles de los lugares

Cantidad de consultas y costo asociado

Conclusión

Una experiencia de descubrimiento local es una forma eficaz de ofrecer valor al 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

Lecturas adicionales sugeridas:

Colaboradores

Autores principales:

Thomas Anglaret | Ingeniero de Soluciones de Google Maps Platform