リクエスト パラメータ

このドキュメントでは、 Places Insights API。それぞれの方法について詳しく説明し、インサイトと 地域データのニーズに合わせてこのツールを使用する際の参考にしてください。

Places Insights API では、次のような重要な機能を実行できます。

  • 場所の数を調べる: 特定の場所に一致する場所の数を特定します さまざまな条件を利用できます。
  • 場所の詳細を取得: 条件を満たす場所の名前を取得し、 フィルタを使ってさらに詳しい情報を取得でき、 Places API
  • 柔軟なフィルタリング: 包括的なフィルタを適用して、正確な分析情報を取得できます。 使用可能なフィルタは次のとおりです。 <ph type="x-smartling-placeholder">
      </ph>
    • 地理的エリア(円、地域、またはカスタム ポリゴン)
    • 場所タイプ
    • 営業状況
    • 価格レベル
    • 評価の範囲

必須パラメータ

このセクションでは、 Places Insights API。各リクエストでは次のものを指定する必要があります。

  • インサイトの一種。
  • 場所フィルタとタイプフィルタ。

分析情報

計算する分析情報の種類を指定します。次の分析情報の種類 サポートされています。

  • INSIGHT_COUNT: フィルタ条件に一致する場所の数を返します。
  • INSIGHT_PLACES: フィルタ条件に一致するプレイス ID を返します。

: このオプションを選択すると、Places Insights API はプレイス ID を返します。 count が 100 以下の場合のみ。

フィルタ

場所をフィルタするための条件を指定します。少なくとも、 LocationFilterTypeFilter

ロケーション フィルタ

ロケーション フィルタには、次のいずれかのタイプがあります。

  • circle: 中心と半径を持つ円としてエリアを定義します。
  • region: エリアをリージョンとして定義します。
  • custom_area: エリアをカスタム ポリゴンとして定義します。
サークル

地理的エリアを円として選択した場合は、center を指定する必要があります。 radius があります。中心には、緯度と経度、または場所を指定できます。 円の中心の ID。

  • center: <ph type="x-smartling-placeholder">
      </ph>
    • lat_lng: 円の中心の緯度と経度。緯度 -90 ~ 90 の数値にする必要があります。経度は数値で指定してください -180 ~ 180 のいずれかを指定します。
    • place: 円の中心の場所 ID。なお、 場所がサポートされています。この文字列は接頭辞 places/ で始める必要があります。
  • radius: 円の半径(メートル単位)。この数値は正数で指定してください。
地域

このエリアは、place パラメータを使用して地域として定義できます。プレイス ID を使用する 地理的エリアを表す あります。たとえば、フロリダ州タンパのプレイス ID は places/ChIJ4dG5s4K3wogRY7SWr4kTX6c

<ph type="x-smartling-placeholder">
サポートされていない地域タイプ
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

Geocoding API 呼び出しの types フィールドを使用して、 プレイス ID に関連付けられた場所や住所のタイプ( 国、市区町村、近隣地域、

カスタム エリア

座標を使用してカスタム ポリゴンの領域を定義します。

https://geojson.io/ にアクセスしてカスタム ポリゴンを描画し、 リクエストに座標を入力しますポリゴンには 4 個以上の 最初と最後の座標は同じです 他の座標は重複してはいけません。 例:

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

タイプフィルタ

追加または除外する場所のタイプを指定します。両方のプライマリ Places Insights API がサポートする第 2 の場所タイプについては、表 A - Places API のプレイスタイプ ガイド (新規)。included_types または included_primary_types のタイプを少なくとも 1 つ指定する必要があります。 含まれます。

  • included_types: 含まれる場所タイプのリスト。
  • excluded_types: 除外する場所タイプのリスト。
  • included_primary_types: 含まれるメインの場所タイプのリスト。
  • excluded_primary_types: 除外するメインの場所タイプのリスト。

タイプフィルタと場所タイプの仕組みについて詳しくは、タイプの詳細をご覧ください。 フィルタ

オプション パラメータ

残りの 3 つのフィルタは省略可能です。

  • operating_status: 追加または除外する場所のステータスを指定します。 デフォルトは operating_status: OPERATING_STATUS_OPERATIONAL でフィルタされます (1 つの特定の値)。
  • price_levels: 場所の価格レベルを指定します。デフォルトは no です フィルタリング(すべての料金レベルが結果に含まれます)。
  • rating_filter: 場所の評価範囲を指定します。デフォルトは no です フィルタリング(すべての評価が結果に含まれます)。

営業状況

営業状況(営業状況、一時的な影響など)に基づいてフィルタ 終了)。

価格帯

価格レベル(無料、中程度、高価など)でフィルタします。

評価フィルタ

ユーザーの平均評価に基づいて場所をフィルタします。どちらのフィールドも 省略可能で、省略すると、デフォルトで場所も取り込まれます。 表示されます

  • min_rating: ユーザーの平均評価の最小値(1.0 ~ 5.0)。
  • max_rating: ユーザーの最大評価の平均(1.0 ~ 5.0)。