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, aprenderás a usar la API de Nearby Search (nueva) para crear una herramienta 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, se compone 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 funciones de Google Maps Platform para mejorar la experiencia con 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 del entorno de una sola ubicación; para ello, muestra 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 y la duración del viaje para que los usuarios entiendan rápidamente si se ajusta a sus necesidades.

Arquitectura de referencia

alt_text

Descubrimiento local

Hay muchas maneras 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 con plantillas para el descubrimiento local, puedes usar los componentes web.

Aplicación de muestra

Explicación de ejemplo

En la tabla a continuación, encontrarás la aplicación de ejemplo desglosada en pasos, además de una descripción de la implementación técnica con las APIs de Google Maps Platform.

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

Carga API de Maps JavaScript.
Consulta Place Autocomplete o selecciona una ubicación en el mapa.

autocompletar de muestra

2. Muestra lugares de interés locales con la API de Nearby Search (nuevo).

Ranking de popularidad (resultados más relevantes) o ranking de distancia.
includedTypes, excludedTypes; si tienes un hotel, puedes excluir el tipo "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 lejanos". En el caso de que el resultado sea CERO, se amplía el tamaño del círculo o del rectángulo antes de mostrar los resultados.

muestras de lugares cercanos

Ejemplo de consulta cuando reservas un hotel con 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 la 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

Se actualizaron los pasos y las etapas consultando la API de Directions. * Usa el tiempo en la siguiente sección.

instrucciones de ejemplo

4. Muestra información detallada del lugar después de la interacción.

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

Tiempo: Proviene de la consulta anterior de la API de Directions.
Opiniones: reviews[i].author, reviews[i].rating,reviews[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, realizar una consulta de a una en tu experiencia.

detalles de lugares

Recuento de consultas y costo asociado

API de Maps JavaScript: 1 mapa durante la carga de la experiencia.
API de Place Autocomplete: se puede personalizar 1 consulta por cada carácter escrito (si se usa el widget de Autocomplete).
API de Nearby Search (nuevo): Se muestra 1 búsqueda 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 cada lugar seleccionado por el usuario.
API de Place Photos: 1 consulta por cada foto que se muestra.

Conclusión

Una experiencia de descubrimiento local es una excelente forma 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

Lectura adicional sugerida:

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