En este documento, aprenderás a usar la API de Nearby Search (nueva) para compilar una estrategia 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 especificas cuando buscan un hotel o una propiedad. 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 productos y capacidades de Google Maps Platform para mejorar la experiencia con la interactividad.
Casos de uso
Ahora, veamos qué elementos de la integración de descubrimiento local generan valor para el usuario:
Descubrimiento: Ofréceles a los usuarios una descripción general de lo que hay alrededor de una sola ubicación mediante la muestra 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.
la duración del viaje y la distancia a pie para que los usuarios entiendan con rapidez si se adaptan.
Arquitectura de referencia
Descubrimiento local
Hay 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 de descubrimiento local con plantillas, puedes usar los componentes web.
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 las APIs de Google Maps Platform.
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 eres un hotel, puedes excluir el tipo de "alojamiento" y solo incluir los tipos adecuados, p. ej., "restaurante, cafetería, parque, tourit_attraction".- Aprovecha
includedPrimaryTypes
yexcludedPrimaryTypes
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 aparezca ningún resultado, amplía el tamaño del círculo o rectángulo antes de 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
- Consulta la API de Directions para actualizar el segmento y los pasos. * 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
ypriceLevel
.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ás consultar Places Details con
place.id
para obtener photo_reference y, luego, hacer una consulta a la vez en tu experiencia
Recuento 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 se usa el widget de Autocomplete) se puede personalizar.
- API de Nearby Search (nueva): Se muestra 1 consulta cada 20 lugares. Facturación diferente según los datos de lugar que forman parte de la respuesta de la consulta.
- API de Directions: 1 consulta por cada lugar que selecciona el usuario.
- API de Place Photo: 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 implementación de demostración tiene muchas funciones que probablemente incluyas al crear una experiencia de este tipo en Google Maps Platform con las funciones 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