Örnekler

Bu bölümde, Places Insights API'ye yapılan bir dizi örnek istek ele alınmaktadır.

computeInsights özelliğini kullanmak için aşağıdaki formu kullanarak HTTP POST isteği gönderin:

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

Bir daire içindeki yerleri döndürme

Londra'daki Trafalgar Meydanı'nın 200 m yarıçapındaki tüm restoranları iade edin.

  • Arama alanı, belirli bir enlem ve boylama odaklı bir dairedir. Bu dairenin yarıçapı 200 metredir ve bu, dairenin boyutunu belirler. alanı seçin.
  • İstenen yer türü restorandır ve bu, type_filters içinde included_types.
  • Sayı, INSIGHTS_COUNT kullanılarak istenir ve yer kimlikleri INSIGHTS_PLACES kullanılarak istendi.
{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_types": "restaurant" }
  }
}

Yer türlerini hariç tut

Ayrıca, yer türlerini sayımdan hariç tutabilirsiniz.

Aşağıdaki istek ilk örnekle aynıdır, ancak excluded_types - type_filters. Bir dize veya dizi kullanabilirsiniz included_types ve excluded_types için dize sayısı.

Bu örnekte iki yer türü hariç tutulur: cafe ve bakery restaurant sayısı.

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

Birincil türü kullan

Bu örnekte, ilk örnekteki istek yalnızca yerleri içerecek şekilde değiştirilir bunlar arasında primaryType restaurant bulunuyor.

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

Özel poligon

Bu örnekte, aramanızı tanımlamak için özel bir poligonun nasıl kullanılacağı gösterilmektedir alanı. INSIGHTS_PLACES belirtmenin aramayı alan kimliği döndürecek kadar küçük alan sağlayın. Daha büyük alanlar için bu sınırlamayı aşmak üzere INSIGHTS_COUNT kullanın. Böylece, hizmetin ayrı ayrı yer kimlikleri döndürmesi gerekmez.

Önceden olduğu gibi, restaurant yer türü kullanılıyor. Bu örnek ayrıca üç filtre daha vardır:

  • operating_status: Bu örnekte yalnızca operasyonel yerler sayılır.
  • price_level: Bu örnek yalnızca ucuz ve orta fiyatlı ürünleri kapsamaktadır yer.
  • rating_filter: Bu örnekte yalnızca yorum puanı 4,0 ile 5,0 arasında olan yerler sayılır.
{
    "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 }
    }
}

Coğrafi bölge

Bu örnekte, arama alanını ayarlamak için Coğrafi Alan yer kimliği kullanılmaktadır. Bu yer kimlikleri, kasaba veya şehir gibi bir yerin geometrisini içerir. İlgili içeriği oluşturmak için kullanılan burada kullanılan yer kimliği, ChIJiQHsW0m3j4ARm69rRkrUF3w değerine karşılık gelir Mountain View, Kaliforniya şehri.

Yer kimliğini Places Insights API'ye iletmek, arama alanını sınırlara ayarlar olduğunu görebilirsiniz. Yer kimliği, place kullanılarak şu biçimde aktarılır: places/<place_ID>.

Coğrafi Alan yer kimliğini aşağıdaki yöntemlerden biriyle edinebilirsiniz:

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