0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

場所検索にGoogle Places APIを使いたい!Nearby Search・Text Searchの違いと料金を調べてみた

0
Posted at

1. はじめに

こんにちは!

皆さんは、居酒屋探しってどうしていますか?
意外と難しくないですか?

上司と行くのか、友達と行くのか。
お互いが住んでいる場所はどこなのか。
予算はいくらくらいなのか。

条件を考えれば考えるほど、居酒屋探しの沼にハマっていきます。

「それならAIに探してもらえばいいのでは?」と思い、生成AIに適当に条件を投げてみました。

しかし、お金をかけたくなかったので安価なモデルを使ってみると……

存在しないお店が出てくる😢

そんなときに知ったのが Google Places API です。
「実在する店舗の検索はGoogle Places APIに任せて、その結果をAIに渡せばいいのでは?」
ということで、今回はGoogle Places APIについて調べてみました!

2. Google Places APIとは

Google公式では、次のように説明されています。

さまざまな方法で位置情報データの HTTP リクエストを受け付けるサービスです。施設、地理的位置、有名なスポットに関するフォーマット済みの位置情報データと画像が返されます。

すごく簡単にいうと、Google Mapでわかる情報を取ってくることができるAPIです!

3. Places APIの主な機能

Places APIには次のAPIが含まれています。
簡単にAIにまとめさせてみました。

API 何をする? 使う場面
Place Details 1つの場所の詳しい情報を取る 住所、営業時間、評価、口コミなどを取得する
Place Photos 場所に紐づく写真を取得する 店舗や施設の画像を画面に表示する
Nearby Search 指定地点の周辺から場所を探す 「現在地から500m以内のレストラン」など
テキスト検索 文字列から場所を探す 「東京駅 居酒屋」「渋谷 カフェ」など
オートコンプリート 入力途中で場所の候補を出す 「東京」と入力 → 「東京駅」などの候補を表示する

Place Detailsは、Place IDを知っておく必要があります。

今回の目的は「条件に合う店舗を探すこと」なので、ここからは Nearby Search と Text Search に絞って見ていきます。

Nearby Search

以下の形式のURL への HTTP POST リクエスト

https://places.googleapis.com/v1/places:searchNearby
  • リクエスト例(公式)

指定地点(緯度 37.7937、経度 -122.3965)から半径500m以内にあるレストランを最大10件検索し、その店舗名を取得するリクエスト

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby

主なパラメータ

項目 必須 内容
X-Goog-FieldMask ○ レスポンスとして取得するフィールドを指定
locationRestriction ○ 検索する位置と範囲を指定
includedTypes - 検索対象のプレイスタイプを指定, 何も指定しない場合は、すべてのタイプが返る
maxResultCount - 取得する最大件数を指定

テキスト検索

以下の形式のURL への HTTP POST リクエスト

https://places.googleapis.com/v1/places:searchText
  • リクエスト例(公式)
    自然な文章(オーストラリア・シドニーにある辛いベジタリアン料理のお店)で場所を検索し、該当する店舗の名前・住所・価格帯を取得するリクエスト
curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

主なパラメータ

項目 必須 内容
X-Goog-FieldMask ○ レスポンスとして取得するフィールドを指定
textQuery ○ 検索したい内容を文字列で指定(公式)

4. お金の話(APIの使用量)

このAPIは無料ではなく、お金かかります😢(使い方によっては無料☺️)

X-Goog-FieldMask に指定するフィールドによって、適用される料金区分(SKU)が変わります。

抑えて欲しいポイント

重要

Field Maskにフィールドを追加するたびに料金が加算されるわけではありません。

複数の料金区分に属するフィールドを指定した場合は、
そのリクエストに含まれる最も高いSKUが適用されます。

公式を確認してどのFieldMaskがどのSKUか把握する必要有り

料金階層

※以下は2026年9月時点の料金です。最新料金はGoogle Maps Platform公式料金表をご確認ください。

公式をみてわかるように、料金区分がそれぞれのAPIによって異なるので、Nearby Searchとテキスト検索のみ表にまとめてみます。

Nearby Searchでは、主に次の3つの料金区分があります。

料金区分 月間無料枠 無料枠を超えた後の料金(~100,000回) イメージ
Pro 5,000回 / 月 $32 / 1,000回 店舗名・住所・Place ID・位置情報などの基本情報を取得
Enterprise 1,000回 / 月 $35 / 1,000回 評価・価格帯・営業時間・Webサイトなど、より詳しい情報を取得
Enterprise + Atmosphere 1,000回 / 月 $40 / 1,000回 口コミ・予約可否・ビール提供・テイクアウトなど、店舗の特徴に関する情報を取得

テキスト検索では、主に次の4つの料金区分があります。

料金区分 月間無料枠 無料枠を超えた後の料金(~100,000回) イメージ
Essentials(IDs Only) 無制限 無料 Place IDなど、場所を識別する最低限の情報のみ取得
Pro 5,000回 / 月 $32 / 1,000回 店舗名・住所など、検索結果として表示する基本情報を取得
Enterprise 1,000回 / 月 $35 / 1,000回 評価・価格帯・営業時間など、より詳しい情報を取得
Enterprise + Atmosphere 1,000回 / 月 $40 / 1,000回 口コミや店舗の特徴など、よりリッチな情報を取得

レスポンスフィールドの確かめる方法は、 公式を確認してください。

5. まとめ

生成AIだけにお店探しを任せると、存在しない店舗が候補として出てくることがあります。
Google Places APIの出力結果をAIに渡すことで、安価なモデルでもかなり精度が良い結果が返ってくることがわかりました!
「場所を検索したい」「生成AIも使いたい」「できるだけコストも抑えたい」という場合には、いい選択肢になるのかなと思いました!

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?