Google Maps Place Detail — API リファレンス

POST

利用可能

/google/maps/detail

Maps 詳細

場所 ID で Google Maps の単一地点を取得します。場所検索を補完し、独自の単価が適用されます。

type

maps_detail

result

place

課金

3 credits

場所 ID で Google Maps の単一地点を取得します。場所検索を補完し、独自の単価が適用されます。

パラメータ

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

feature_id

必須

string

必須

Maps Search の地点結果で返る feature_id フィールドを使用します。形式は 0x...:0x...。

hl

任意

string

任意

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

gl

任意

string

任意

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

id

例

string

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

例: "ChIJVVVVVYxK1EARyQpK5cQqEAA"

json

{
  "id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}

Playground で実行

レスポンスフィールド

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

feature_id

必須

string

必須

地図詳細リクエストから解決した feature_id。

page

必須

number

必須

地図詳細では常に 1。

place

任意

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/detail' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"ChIJVVVVVYxK1EARyQpK5cQqEAA"}'

既存の Google リクエスト例

bash

curl -X POST https://api.serpbase.dev/google/maps/detail \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
    "hl": "en",
    "gl": "us"
  }'

注記

地点データ拡充、ローカル CRM、詳細ページ。

Maps 検索結果の feature_id を使って詳細を取得します。形式が正しくても不明な feature_id は status 1004 を返します。