Anfrageparameter

Dieses Dokument bietet einen klaren Überblick über alle Parameter im Places Insights API Wir gehen auf jedes Thema im Detail ein und bieten Ihnen Verfahren, die Ihnen bei der Verwendung dieses Tools für Ihre geografischen Datenerfordernisse helfen.

Mit der Places Insights API können Sie mehrere wichtige Funktionen ausführen:

  • Orte zählen: Ermitteln Sie die Anzahl der Orte, die mit bestimmten Kriterien wie Standorttyp, Öffnungsstatus, Preisniveau und Bewertungen.
  • Ortsdetails abrufen: Ermitteln Sie die Namen von Orten, die den Filteroptionen festlegen und mithilfe der Funktion Places API
  • Flexibles Filtern: Umfassende Filter bieten die Möglichkeit, präzise Informationen zu erhalten. Folgende Filter sind verfügbar: <ph type="x-smartling-placeholder">
      </ph>
    • Geografisches Gebiet (Kreis, Region oder benutzerdefiniertes Polygon)
    • Ortstypen
    • Öffnungsstatus
    • Preisstufen
    • Altersfreigaben

Erforderliche Parameter

In diesem Abschnitt werden die erforderlichen Parameter für das Senden einer Anfrage an den Places Insights API Jede Anfrage muss Folgendes enthalten:

  • Eine Art von Erkenntnis.
  • Einen Standort- und Typfilter.

Insight

Gibt den Typ der Statistiken an, die berechnet werden sollen. Die folgenden Statistiktypen werden unterstützt:

  • INSIGHT_COUNT: gibt die Anzahl der Orte zurück, die den Filterkriterien entsprechen.
  • INSIGHT_PLACES: Gibt die Orts-IDs zurück, die den Filterkriterien entsprechen.

Hinweis: Wenn diese Option ausgewählt ist, gibt die Places Insights API Orts-IDs zurück. wenn count 100 oder weniger beträgt.

Filter

Gibt die Kriterien zum Filtern von Orten an. Sie müssen mindestens die LocationFilter und TypeFilter.

Filter für Standort

Standortfilter können einen der folgenden Typen haben:

  • circle: definiert einen Bereich als Kreis mit einem Mittelpunkt und einem Radius.
  • region: Definiert ein Gebiet als Region.
  • custom_area: definiert eine Fläche als benutzerdefiniertes Polygon.
Kreis

Wenn Sie Ihr geografisches Gebiet als Kreis auswählen, müssen Sie eine center angeben und radius. Der Mittelpunkt kann entweder ein Breiten- und Längengrad oder der Ort sein ID des Kreismittelpunkts

  • Mitte: <ph type="x-smartling-placeholder">
      </ph>
    • lat_lng: Breiten- und Längengrad des Mittelpunkts des Kreises. Breitengrade muss eine Zahl zwischen -90 und 90 (jeweils einschließlich) sein. Der Längengrad muss eine Zahl sein zwischen -180 und 180 (einschließlich).
    • place: Orts-ID der Kreismitte. Beachten Sie, dass nur Punkt Orte unterstützt werden. Dieser String muss mit dem Präfix places/ beginnen.
  • radius: Radius des Kreises in Metern. Diese Zahl muss positiv sein.
Region

Mit dem Parameter place können Sie Ihre Region als Region definieren. Orts-ID verwenden der ein geografisches Gebiet darstellt (z. B. ein Gebiet, das durch eine Polygon). Die Orts-ID von Tampa, FL ist beispielsweise places/ChIJ4dG5s4K3wogRY7SWr4kTX6c

<ph type="x-smartling-placeholder">
Nicht unterstützte Regionstypen
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

Mit dem Feld types aus einem Geocoding API-Aufruf lässt sich bestimmen, Der Typ des Standorts oder der Adresse, die mit einer Orts-ID verknüpft ist, z. B. ob es sich um Stadt, Stadtteil oder Land.

Benutzerdefinierter Bereich

Definiert die Fläche eines benutzerdefinierten Polygons mithilfe von Koordinaten.

Unter https://geojson.io/ können Sie ein benutzerdefiniertes Polygon zeichnen. und geben Sie diese Koordinaten in die Anfrage ein. Ein Polygon muss mindestens vier Elemente haben. -Koordinaten, wobei die erste und die letzte Koordinate identisch sind. Neben der Koordinaten haben, dürfen keine weiteren Koordinaten doppelt vorhanden sein. Beispiel:

"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
   }
]

Typfilter

Gibt die Ortstypen an, die ein- oder ausgeschlossen werden sollen. Für eine Liste mit den primären und sekundäre Ortstypen, die von der Places Insights API unterstützt werden, finden Sie in der Tabelle A im Leitfaden zu Ortstypen für die Places API (Neu). Mindestens ein included_types- oder included_primary_types-Typ muss sein enthalten.

  • included_types: Liste der enthaltenen Ortstypen.
  • excluded_types: Liste der ausgeschlossenen Ortstypen.
  • included_primary_types: Liste der enthaltenen primären Ortstypen.
  • excluded_primary_types: Liste der ausgeschlossenen primären Ortstypen.

Weitere Informationen zur Funktionsweise von Typfiltern und Ortstypen finden Sie unter diesem Link Filter.

Optionale Parameter

Die übrigen drei Filter sind optional:

  • operating_status: Gibt den Status der ein- oder auszuschließenden Orte an. Standardmäßig wird nach operating_status: OPERATING_STATUS_OPERATIONAL gefiltert (ein bestimmter Wert).
  • price_levels: Gibt die Preisstufen der Orte an. Die Standardeinstellung ist „nein“. Filterung (alle Preisstufen sind in den Ergebnissen enthalten).
  • rating_filter: Gibt den Bewertungsbereich der Orte an. Die Standardeinstellung ist „nein“. Filtern (alle Bewertungen sind in den Ergebnissen enthalten).

Öffnungsstatus

Filtern nach Betriebsstatus (z. B. in Betrieb oder vorübergehend) geschlossen).

Preisniveau

Filtern Sie nach Preisniveau (z. B. kostenlos, moderat oder teuer).

Filter „Bewertung“

Filtert Orte anhand ihrer durchschnittlichen Nutzerbewertungen. Beide Felder sind optional. Werden sie weggelassen, umfassen sie standardmäßig auch Orte, die keine Bewertung haben.

  • min_rating: Minimale durchschnittliche Nutzerbewertung (zwischen 1,0 und 5,0).
  • max_rating: Maximale durchschnittliche Nutzerbewertung (zwischen 1,0 und 5,0).