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

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.

descubrimiento local de muestra

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

alt_text

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.

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 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 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 aparezca ningún resultado, amplía el tamaño del círculo o rectángulo antes de mostrar los resultados.

muestra de lugares cercanos

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.

ejemplos de instrucciones sobre cómo llegar

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

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

    Hora: 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ás consultar Places Details con place.id para obtener photo_reference y, luego, hacer una consulta a la vez en tu experiencia

detalles de lugares

Recuento de consultas y costo asociado

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:

Colaboradores

Autores principales:

Thomas Anglaret | Ingeniero de soluciones de Google Maps Platform