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äfixplaces/
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
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 nachoperating_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).