Se usó la API de Cloud Translation para traducir esta página.

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

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

experiencia 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, 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 funciones de Google Maps Platform para mejorar la experiencia con la interactividad.

descubrimiento local de muestra

Casos de uso

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

Discovery: Muestra 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 la distancia del recorrido 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 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 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 Place Autocomplete o elige una ubicación en el mapa.

ejemplo de autocompletado

2. Muestra lugares 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 tienes un hotel, puedes excluir el tipo “alojamiento” y solo incluir los tipos adecuados, p. ej., “restaurante, cafetería, parque, atracción turística”.
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 el rectángulo antes de mostrar los resultados.

muestra lugares cercanos

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

Básica (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á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 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.

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

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

Hora: proviene de la consulta anterior a la API de Directions.

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

Imágenes: Durante la versión preliminar sin restricciones de la API de Nearby Search (nueva), deberás consultar Places Details 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

API de Maps JavaScript: 1 mapa cuando se carga la experiencia
API de Place Autocomplete: 1 consulta por cada carácter escrito (si usas el widget de Autocomplete), se puede personalizar.
API de Nearby Search (nueva): 1 consulta por cada 20 lugares que se muestran Facturación diferente según los datos de Place que forman parte de la respuesta de la consulta.
API de Directions: 1 consulta por cada lugar que seleccione el usuario
API de Place Photo: 1 consulta por cada foto que se muestra

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:

Componentes web en la API de Maps JavaScript
Optimización de Place Autocomplete
Otros servicios de Places
Deja tus comentarios a continuación.

Colaboradores

Autores principales:

Thomas Anglaret | Ingeniero de Soluciones de Google Maps Platform