Beispiele

In diesem Abschnitt wird eine Reihe von Beispielanfragen an die Places Insights API behandelt.

Senden Sie eine HTTP-POST-Anfrage im folgenden Format, um computeInsights zu verwenden:

https://areainsights.googleapis.com/v1:computeInsights

Orte innerhalb eines Kreises zurückgeben

Geben Sie alle Restaurants im Umkreis von 200 m um den Trafalgar Square, London, an.

  • Der Suchbereich ist ein Kreis, dessen Mittelpunkt ein bestimmter Breiten- und Längengrad ist. Der Radius dieses Kreises beträgt 200 Meter und bestimmt die Größe des Kreises. Suchbereich.
  • Der angeforderte Ortstyp lautet „restaurant“ und wird übergeben mit included_types innerhalb von type_filters.
  • Die Zählung wird mit INSIGHTS_COUNT angefordert und die Orts-IDs sind mit INSIGHTS_PLACES angefordert.
{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_types": "restaurant" }
  }
}

Ortstypen ausschließen

Sie können auch Ortstypen aus der Zählung ausschließen.

Die folgende Anfrage ist mit dem ersten Beispiel identisch, fügt jedoch excluded_types zum type_filters. Sie können entweder einen String oder ein Array verwenden von Strings für included_types und excluded_types.

In diesem Beispiel werden die beiden Ortstypen cafe und bakery aus dem Anzahl: restaurant.

{
    "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
    "filter": {
        "location_filter": {
            "circle": {
                "lat_lng": { "latitude": 51.508, "longitude": -0.128},
                "radius": 200
            }
        },
        "type_filter": {
            "included_types": "restaurant",
            "excluded_types": [
                "cafe",
                "bakery"
            ]
        }
    }
}

Primären Typ verwenden

In diesem Beispiel wird die Anfrage aus dem ersten Beispiel so geändert, dass nur Orte berücksichtigt werden. in der Anzahl den primaryType-Wert restaurant enthält.

{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_primary_types": "restaurant" }
  }
}

Benutzerdefiniertes Polygon

In diesem Beispiel wird gezeigt, wie Sie die Suche mit einem benutzerdefinierten Polygon definieren. Bereich. Beachten Sie, dass durch Angabe von INSIGHTS_PLACES die Suche auf Folgendes eingeschränkt wird: die klein genug sind, um bis zu 100 Orts-IDs zurückzugeben. Verwenden Sie für größere Gebiete INSIGHTS_COUNT, um diese Einschränkung zu umgehen, sodass der Dienst nicht einzelne Orts-IDs zurückgeben.

Wie zuvor wird der Ortstyp restaurant verwendet. In diesem Beispiel werden auch drei weitere Filter vorgestellt:

  • operating_status: In diesem Beispiel werden nur betriebsbereite Orte gezählt.
  • price_level: In diesem Beispiel werden nur Orte mit günstigen und durchschnittlichen Preisen gezählt.
  • rating_filter: In diesem Beispiel werden nur Orte mit einer Bewertung zwischen 4,0 und 5,0 gezählt.
{
    "insights": [ "INSIGHT_COUNT" ],
    "filter": {
        "location_filter": {
            "custom_area": {
                "polygon": {
                    "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 }
                    ]
                }
            }
        },
        "type_filter": {
            "included_types": "restaurant"
        },
        "operating_status": [ "OPERATING_STATUS_OPERATIONAL" ],
        "price_levels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ],
        "rating_filter": { "min_rating": 4.0, "max_rating": 5.0 }
    }
}

Geografischer Bereich

In diesem Beispiel wird eine Orts-ID aus dem Bereich Region verwendet, um den Suchbereich festzulegen. Diese Orts-IDs umfassen die Geometrie eines Ortes, z. B. eine Stadt. Die die hier verwendete Orts-ID ChIJiQHsW0m3j4ARm69rRkrUF3w, die dem Stadt in Mountain View, Kalifornien.

Wenn Sie die Orts-ID an die Places Insights API übergeben, wird der Suchbereich auf die Grenzen des geografischen Gebiets festgelegt. Die Orts-ID wird mit place im Format places/<place_ID>.

Sie haben folgende Möglichkeiten, eine Orts-ID für ein geografisches Gebiet zu erhalten:

{
    "insights": [
        "INSIGHT_COUNT"
    ],
    "filter": {
        "location_filter": {
            "region": {
                "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w"
            }
        },
        "type_filter": {
            "included_types": [
                "restaurant"
            ]
        }
    }
}