parámetros de solicitud

Este documento proporciona una descripción general clara de todos los parámetros dentro del API de Places Insights Analizaremos cada uno en detalle, ofreceremos estadísticas y prácticas para ayudarte a usar esta herramienta para tus necesidades de datos geográficos.

La API de Places Insights te permite realizar varias funciones clave:

  • Recuento de lugares: Determina la cantidad de lugares que coinciden con datos específicos. como el tipo de ubicación, el estado operativo, el nivel de precio y las calificaciones.
  • Recuperar detalles del lugar: Obtén los nombres de los lugares que cumplen con los filtros especificados, recupera información más detallada mediante el API de Places.
  • Filtros flexibles: Aplique filtros completos para obtener estadísticas precisas. Entre los filtros disponibles, se incluyen los siguientes:
    • Área geográfica (círculo, región o polígono personalizado)
    • Tipos de lugares
    • Estado operativo
    • Niveles de precios
    • Rangos de clasificación

Parámetros obligatorios

En esta sección, se abarcan los parámetros requeridos al emitir una solicitud a la API de Places Insights Cada solicitud debe proporcionar la siguiente información:

  • Un tipo de estadística.
  • Un filtro de ubicación y un filtro de tipo

Estadística

Especifica el tipo de estadísticas que quieres calcular. Los siguientes tipos de estadísticas compatibles:

  • INSIGHT_COUNT: Muestra la cantidad de lugares que coinciden con los criterios de filtro.
  • INSIGHT_PLACES: Muestra los IDs de lugar que coinciden con los criterios del filtro.

Nota: Si se selecciona esta opción, la API de Places Insights muestra los IDs de lugar solo si count es 100 o menos.

Filtro

Especifica los criterios para filtrar lugares. Como mínimo, debes especificar el LocationFilter y TypeFilter.

Filtro de ubicación

Un filtro de ubicación puede tener uno de los siguientes tipos:

  • circle: Define un área como círculo con un centro y un radio.
  • region: Define un área como una región.
  • custom_area: Define un área como un polígono personalizado.
Círculo

Si seleccionas tu área geográfica como círculo, debes proporcionar un center. y una radius. El centro puede ser una latitud y longitud, o el lugar ID del centro del círculo.

  • centro:
    • lat_lng: La latitud y la longitud del centro del círculo. Latitudes debe ser un número entre -90, 90, inclusive. La longitud debe ser un número entre -180, 180, inclusive.
    • place: Es el ID de lugar del centro del círculo. Ten en cuenta que solo el modo lugares son compatibles. Esta cadena debe comenzar con el prefijo places/.
  • radius: Radio del círculo en metros Este número debe ser positivo.
Región

Puedes definir tu área como una región con el parámetro place. Cómo usar un ID de lugar que representa un área geográfica (como un área representable por un polígono). Por ejemplo, el ID de lugar de Tampa, FL es places/ChIJ4dG5s4K3wogRY7SWr4kTX6c

Tipos de regiones no compatibles
establishment place_of_worship
floor post_box
food postal_code_suffix
general_contractor room
geocode street_address
health street_number
intersection sublocality_level_5
landmark subpremise

Puedes usar el campo types de una llamada a la API de Geocoding para determinar la tipo de ubicación o dirección asociada con un ID de lugar; por ejemplo, si se trata de un ciudad, vecindario o país.

Área personalizada

Define el área de un polígono personalizado mediante coordenadas.

Puedes visitar https://geojson.io/ para dibujar un polígono personalizado y ingresar esas coordenadas en la solicitud. Un polígono debe tener al menos 4. coordenadas, en las que la primera y la última son idénticas. Además del primera y última coordenada, no debe haber ninguna otra coordenada duplicada. Por ejemplo:

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

Filtro de tipos

Especifica los tipos de lugares que se incluirán o excluirán. Para obtener una lista de ambas y los tipos de lugares secundarios que admite la API de Places Insights, consulta la Tabla A en la guía Tipos de lugares para la API de Places (Nuevo). Se debe tener al menos un tipo de included_types o included_primary_types incluidos.

  • included_types: Lista de tipos de lugares incluidos.
  • excluded_types: Lista de tipos de lugares excluidos.
  • included_primary_types: Lista de tipos de lugares principales incluidos.
  • excluded_primary_types: Lista de tipos de lugares principales excluidos.

Para obtener más información acerca de cómo funcionan los filtros de tipo y los tipos de lugares, consulta Más información sobre tipos filtros.

Parámetros opcionales

Los tres filtros restantes son opcionales:

  • operating_status: Especifica los estados de los lugares que se incluirán o excluirán. La configuración predeterminada es filtrar por operating_status: OPERATING_STATUS_OPERATIONAL. (un valor específico).
  • price_levels: Especifica los niveles de precio de los lugares. La configuración predeterminada es "no". filtrado (todos los niveles de precios se incluyen en los resultados).
  • rating_filter: Especifica el rango de calificación de los lugares. La configuración predeterminada es "no". filtrado (todas las calificaciones se incluyen en los resultados).

Estado operativo

Filtra según el estado operativo (por ejemplo, operativo o temporal). cerrado).

Nivel de precio

Filtra según el nivel de precio (por ejemplo, gratuito, moderado o costoso).

Filtro de clasificación

Filtra los lugares según las calificaciones promedio de los usuarios. Ambos campos son opcionales y, si se omiten, se incluirán de forma predeterminada también lugares que no tienen una calificación.

  • min_rating: Es la calificación mínima promedio de los usuarios (entre 1.0 y 5.0).
  • max_rating: Indica la calificación promedio máxima de los usuarios (entre 1.0 y 5.0).