Google Maps Search — API リファレンス

POST

利用可能

/google/maps/search

Maps 検索

クエリと位置で Google Maps の場所を検索します。特定の場所の詳細には別のエンドポイントを使います。

type

maps_search

result

places

課金

2 credits

クエリと位置で Google Maps の場所を検索します。特定の場所の詳細には別のエンドポイントを使います。

パラメータ

フィールド型出現条件説明

q

必須

string

必須

検索クエリ文字列。

hl

任意

string

任意

言語コード。デフォルトは en。

gl

任意

string

任意

国コード。デフォルトは us。

page

任意

number

任意

1 始まりのページ番号。デフォルトは 1。

lat

任意

number

任意

地図中心の緯度。lng と一緒に送信します。

lng

任意

number

任意

地図中心の経度。lat と一緒に送信します。

zoom

任意

number

任意

地図ズーム。1 から 21。座標指定時のデフォルトは 14。

location

例

object

カタログの例。必須項目は API が検証します。

例: {"location_query":"Seattle, WA"}

query

例

string

カタログの例。必須項目は API が検証します。

例: "coffee"

json

{
  "location": {
    "location_query": "Seattle, WA"
  },
  "query": "coffee"
}

Playground で実行

レスポンスフィールド

フィールド型出現条件説明

query

必須

string

必須

リクエストから正規化されたクエリ。

page

必須

number

必須

現在の 1 始まりのページ番号。

places

任意

MapsPlace[]

地域の場所が解析された場合。

地域の場所の検索結果。

MapsPlace 結果アイテム構造

フィールド型出現条件説明

position

任意

number

Maps 検索のみ。

地域結果での場所の順位。

name

必須

string

必須

場所の名前。

title

必須

string

必須

name の別名。

feature_id

必須

string

必須

Google Maps の feature ID。

place_id

任意

string

Google が公開する場合。

Google の場所 ID。

data_id

任意

string

feature_id の別名。

Maps のデータ ID。

cid

任意

string

可能なら feature_id から導出。

Google の CID。

kgmid

任意

string

Maps データに存在する場合。

ナレッジグラフのマシン ID。

google_maps_url

任意

string

Google が Maps URL を公開する場合。

Google Maps の URL。

url

任意

string

google_maps_url、なければ website。

場所の主 URL。

rating

任意

number

評価がある場合。

Google の評価。

types

任意

string[]

カテゴリーがある場合。

場所の種類ラベル。

category

任意

object

カテゴリーが解析された場合。

構造化カテゴリーデータ。

address

任意

string

住所がある場合。

整形された住所。

address_components

任意

object

住所の構成要素がある場合。

通り、市、郵便番号、国コード。

plus_code

任意

object

Plus Code がある場合。

グローバル・複合 Plus Code。

phone

任意

string

電話番号がある場合。

現地形式の電話番号。

phone_international

任意

string

存在する場合。

国際形式の電話番号。

phone_uri

任意

string

存在する場合。

電話の URI。

website

任意

string

ウェブサイトがある場合。

事業者のウェブサイト。

website_domain

任意

string

サイトのドメインがある場合。

事業者サイトのドメイン。

latitude

任意

number

座標がある場合。

緯度。

longitude

任意

number

座標がある場合。

経度。

image

任意

string

画像がある場合。

場所の主画像。

thumbnail

任意

string

画像があれば image の別名。

主画像の別名。

photos

任意

MapsPhoto[]

写真が解析された場合。

写真 ID、URL、サイズ、任意の座標。

hours

任意

Record<string,string>

営業時間が解析された場合。

曜日別の営業時間。

open_status

任意

object

営業状態がある場合。

営業状態と現在の営業時間。

attributes

任意

object[]

属性が解析された場合。

グループ化された場所の属性。

related_places

任意

object[]

関連する場所がある場合。

Maps データの関連する場所。

short_description

任意

string

説明ブロックがある場合。

場所の短い説明。

description

任意

string

説明ブロックがある場合。

場所の詳しい説明。

snippet

任意

string

short_description、なければ description。

正規化された要約。

timezone

任意

string

存在する場合。

場所のタイムゾーン。

region

任意

string

存在する場合。

地域ラベル。

country_code

任意

string

存在する場合。

国コード。

language

任意

string

存在する場合。

Maps データの言語コード。

コードとレスポンスの例

bash

curl -X POST 'https://api.serpbase.dev/google/maps/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"location":{"location_query":"Seattle, WA"},"query":"coffee"}'

既存の Google リクエスト例

bash

curl -X POST https://api.serpbase.dev/google/maps/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "coffee",
    "hl": "en",
    "gl": "us",
    "page": 1,
    "lat": 37.7749,
    "lng": -122.4194,
    "zoom": 14
  }'

注記

ローカル発見、店舗検索、地域別監査。

lat と lng は同時に送信します。zoom は座標指定時のみ有効で既定値は 14 です。