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 especificas cuando buscas un hotel o un bien inmobiliario. A menudo, consta de un mapa interactivo, con un panel adicional que contiene un selector de lugares y una galería de fotos. Verás diferentes ofertas de Google Maps Platform productos y capacidades para mejorar la experiencia con la interactividad.
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: Brinda a los usuarios la posibilidad de 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 la distancia y el tiempo de caminata para que los usuarios entiendan rápidamente si se ajusta sus necesidades.
Arquitectura de referencia
Descubrimiento local
Hay muchas formas de crear una experiencia de descubrimiento local. Lo siguiente es un ejemplo personalizado de una experiencia del usuario que aprovecha las APIs de Google Maps Platform conocidas, así como algunas funciones nuevas y emocionantes. Si Si deseas tener un enfoque basado en plantillas para el descubrimiento local, puedes usar la página Componentes.
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
- Carga la API de Maps JavaScript.
- Consulta Place Autocomplete o elige una ubicación en el mapa.
2. Muestra lugares 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 es un hotel, puede excluir tipo “alojamiento” e incluya solo los tipos adecuados, p. ej., “restaurante, cafetería, parque, Tourit_attraction”.- Aproveche
includedPrimaryTypes
,excludedPrimaryTypes
para obtener aún más control sobre los resultados. - "locationRestriction para evitar una cantidad insuficiente de resultados o una distancia demasiado lejana" lugares; en caso de CERO resultados, amplíe el tamaño del círculo / rectángulo antes para mostrar los resultados.
Consulta de muestra cuando reservas 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 } } }
Consulta de muestra cuando buscas un inmueble 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 Dynamic Maps y la API de Directions
- Actualiza el segmento y los pasos mediante la consulta de Instrucciones sobre cómo llegar API * Usa la hora en la siguiente sección.
4. Muestra información detallada del lugar luego de la interacción.
Descripción:
displayName
,types
,rating
,userRatingCount
,priceLevel
Hora: Proviene de la consulta anterior a la API de Directions.
Opiniones:
reviews[i].author
,reviews[i].rating
yreviews[i].text
.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
Recuento de consultas y costo asociado
- Maps JavaScript API: 1 cuando se cargue la experiencia.
- API de Place Autocomplete: 1 consulta por cada carácter escrito (si se utiliza el Autocompletar Widget), se puede personalizar.
- Nearby Search (nuevo) API: Se muestra 1 consulta cada 20 lugares. Facturación diferente según Place datos que son parte de la respuesta a la consulta.
- Instrucciones sobre cómo llegar API: 1 consulta por cada lugar seleccionado por el usuario.
- Foto del lugar API: 1 consulta por cada foto que se muestra.
Conclusión
Una experiencia de descubrimiento local es una excelente manera de ofrecer valor al usuario. Esta la implementación de demostración tiene muchas funciones que es probable que incluyas cuando y creamos una experiencia de este tipo en Google Maps Platform con capacidades especiales desde la API de Nearby Search (nuevo)
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 | Google Maps Ingeniero de soluciones de la plataforma