このドキュメントでは、 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 以下の場合のみ。
フィルタ
場所をフィルタするための条件を指定します。少なくとも、
LocationFilter
と TypeFilter
。
ロケーション フィルタ
ロケーション フィルタには、次のいずれかのタイプがあります。
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
。
サポートされていない地域タイプ | |
---|---|
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)。