ドキュメントを探す
API リファレンス
Google Places API
現地企業や場所を探す 利用可能な場合、名前、住所、座標、評価、連絡先の詳細を取得します。
リクエストを作成
詳細パラメーター
1 から始まります。ページごとに個別のリクエストが必要です。
Google tbs 式。 サポートされているフィルタは検索タイプにより異なります。
https://data.flashdata.dev/v1/queries/realtimeパラメーター
送信 source とりあえず query 最上位レベル。 ソースのオプションは、 params. オプションのフィールドは省略可能です。
リクエストボディ
sourcestring / 必須- google_placesに設定します。
querystring / 必須- クエリを検索します。 Googleの検索演算子をサイト: と intitle などのサポートします。1 へ へ へ へ 2,000 キャラクターデフォルト:
設定なし paramsobject / 任意- この要求のためのSettings。デフォルト:
{} callback_urlstring · nullable / 任意- Asyncとバッチだけ。 パブリック HTTPS エントリーフォーム URL 港に 443まで、 2,048 文字。 ユーザーの資格情報や URL フラグメントはありません。 Omit は、通知なしの null または空の文字列を使用します。 バッチでは、各クエリで、外部のパラメータで設定します。デフォルト:
設定なし
国、言語、場所
params.glstring / 任意- 私たち、gb、de、sg などの2文字の国コード。 国を選択するために明示的に設定します。正確に 2 キャラクターデフォルト:
設定なし受け入れられたフォーマット
^[A-Za-z]{2}$ params.hlstring / 任意- Googleインターフェイス言語。 言語を選択するために明示的に設定します。1 へ へ へ へ 35 キャラクターデフォルト:
設定なし受け入れられたフォーマット
^[A-Za-z0-9-]+$ params.locationstring / 任意- "London, England, United Kingdom"のような都市、好ましく検索場所を要求しました。 空室状況は検索タイプによって異なります。1 へ へ へ へ 200 キャラクターデフォルト:
設定なし
パジネーション
params.numinteger / 任意- リクエストされた結果のカウント。 FlashData は省略時に固定されたデフォルトは追加しません。 返されたカウントはクエリと検索タイプによって異なる場合があります。1 へ へ へ へ 100, 数字全体デフォルト:
設定なし params.pageinteger / 任意- リクエスト結果ページ。 明示的に設定します。 各ページは別々のAPIリクエストです。1 へ へ へ へ 100, 数字全体デフォルト:
設定なし
フィルターを検索
params.tbsstring / 任意- qdr:d などの Google の検索フィルタを、過去の曜日または qdr:w の qdr:d などのリクエストした。 空室状況は検索タイプによって異なります。1 へ へ へ へ 200 キャラクターデフォルト:
設定なし params.autocorrectboolean / 任意- true でスペル補正をリクエストするか、false で無効にリクエストしてください。 応用動作は検索タイプによって異なります。 Googleの動作を使用する省略。
trueまたはfalseデフォルト:設定なし
レスポンス
Realtime のリターン status: done 検索出力で results[0]. マッチはあります results[0].places. usage.credits チャージを記録します。
結果は、利用可能なときにアドレスや座標を含む場所を記述します。 格付けと連絡先の詳細はオプションです。地理的問題が発生した場合は、明示的な国と場所の設定を使用してください。
結果を読む
response.jsonとして成功するJSON応答を保存します。 これをread-response.pyとして保存し、python read-response.pyを実行します。 Pythonの標準ライブラリのみを使用し、新しいリクエストは使用しません。
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = [
{name: item.get(name) for name in ("title", "address", "latitude", "longitude", "website")}
for item in result.get("places", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))利用可能なフィールドは、クエリと検索タイプによって異なります。 オプションのフィールドは不在であり、追加のフィールドが返される場合があります。
params.num は返された項目の数と searchParameters.num と異なることができます。 返された配列を使用して、実際の結果のカウントを決定します。
すべての応答フィールド
| フィールド | 説明: |
|---|---|
sourcestring | 要求されたAPIの源。 |
statusstring | リアルタイムリクエストが成功したときに行われる。 |
created_atstring | ISO 8601 形式の応答作成時間。 |
usage.creditsnumber | リクエストに応じて請求されるクレジットは、プランに基づいて行われます。 |
results[0].searchParametersobject | Googleで報告された検索設定は、クエリがqとして記録されています。 返された設定は、要求された値と異なる場合があります。 |
results[0].placesarray | ローカル検索結果。 |
results[0].places[].titlestring | 氏名、商号 |
results[0].places[].addressstring · optional | ストリートアドレス。 |
results[0].places[].latitudenumber · optional | 緯度.. |
results[0].places[].longitudenumber · optional | 経度。 |
results[0].places[].ratingnumber · optional | 平均評価。 |
results[0].places[].ratingCountinteger · optional | 評価件数。 |
results[0].places[].categorystring · optional | 営業品目 |
results[0].places[].phoneNumberstring · optional | リストされた電話番号。 |
results[0].places[].websitestring · optional | 営業サイト |
results[0].places[].cidstring · optional | Googleの場所の識別子。 |
results[0].places[].positioninteger | 結果の位置。 |
results[0].places[].priceLevelstring · optional | 利用できる場合の表示された価格のレベル。 |
上記のフィールドは、デフォルトの JSON 応答を記述します。 JSON, テキストとMarkdownフォーマット.
Async及びバッチ ライフサイクル
提出は、結果ではなく、領収書を返します。 Async は 1 つのジョブを作成します。 バッチは別のジョブを返します。 queries[] あらゆる問い合わせに対応。 各ジョブを独立して追跡し、取得します。
提出する data.flashdata.dev; ジョブの状態と結果を読みます api.flashdata.dev 同じ X-API-Key を使って。 リンクしたAPIの基本例では、PythonとcURLを使用しています。
1. ジョブを保存 IDs
Asyncに切り替えるときに、このソースの要求フィールドをキープします。 Batch では、JSON オブジェクトのクエリ配列に各リクエストを入力します。 ID を返すジョブを全て保存します。
2. ステータスの確認
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: 遅延と敬意のある投票Retry-After現時点ではcompleted: 結果を取得します。failed: 検査job.error.job.status を読んでください。投稿レシートのステータスはありません。
ジョブステータス API 参照3. フェッチ結果
GET https://api.flashdata.dev/v2/jobs/{jobId}/results完了後、結果が読み込まれたことを認証し、取得します。 302 ストレージ URL あなたなしで API キー。 24 内の JSON を完成時間内に保存します。
フェッチ結果 · Python と cURL · レスポンス形式
結果は、APIリファレンスをダウンロード
既存の結果のポーリングとフェッチは、クエリクレジットを消費しません。 ポーリングのタイムアウトはジョブをキャンセルしません。重複した課金の作業を投稿する代わりに、IDをキープします。 エラーコードと再試行動作.
完了通知 Webhook
クエリごとに購読する
セットセット callback_url 非同期リクエストのトップレベル、または 各クエリの内部 バッチで、外側 params. 別途のwebhook-registrationリクエストが必要です。 Realtime リクエストはコールバックを送信しません。
公共利用 HTTPS URL 港に 443. FlashData POSTsは、各ジョブが到達する通知を送信します completed または failed; イベントは、結果自体ではなく、リンクが含まれています。
アクノレッジと検証
返品について 2xx イベントを厳しく受け入れた後。 重複排除 delivery_id, 、またとして送られます X-Delivery-Id. リダイレクトは続行しません。
緊急の配送再試行、最大 8 は合計を試みます そして最も 24 完了後時間. フォールバックとして花粉を保ちます。
コールバックは未署名です。 ジョブの ID、ソース、ターミナルの状態を経由して確認する 認証されたステータスエンドポイント 通知を処理する前に。 配達IDは信憑性の証拠ではなく、解読のためです。
Webhookイベントとフィールドの例
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "google_places",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| フィールド | 説明: |
|---|---|
delivery_idstring | 安定した配達識別子。 この値を使用して通知を複製します。また、X-Delivery-Id ヘッダーに送信されます。 |
idstring | 求人 ID. |
sourcestring | リクエストされたデータソース。 |
statusstring | 完了または失敗。 |
linksarray | ステータスと結果のリンク。 結果のコンテンツやAPIキーは、通知は含まれていません。 |
links[].relstring | 自己または結果。 |
links[].hrefstring | 絶対管理 API URL;あなたのAPIのキーと認証して下さい。 |
links[].methodstring | GET.の特長 |
エラー回復
完了した検索には、要求されるよりも少数のマッチが含まれている場合があります。 インフォメーション gl, hl, 、場所およびフィルター;任意豊富なresultの分野は不在であるかもしれません。
認証、残高、リクエスト形式、レート制限の失敗については、共有エラー参照を使用します。 提出期限は、まだジョブを作成している可能性があります。 再試行する前に、既存の作業を確認してください。
エラーとステータスコード · 再試行するとき · レート制限
ステップバイステップガイド: Google検索を選択および精製
料金
| プラン | 使用法率1,000リクエストあたり | サブスクリプション | 請求期間ごとのクレジットを含む |
|---|---|---|---|
| 従量課金 | $1.00 | 月額料金なし | 必要に応じてチャージ |
| Micro | $0.80 | $49.00 / 月 月 日 | 1,000クレジット($50.00のAPI使用)付属 |
| Starter | $0.65 | $199.00 / 月 月 日 | 4,000クレジット($200.00のAPI使用)付属 |
| Pro | $0.60 | $499.00 / 月 月 日 | 10,000クレジット($500.00のAPI使用)付属 |
| Scale | $0.50 | $999.00 / 月 月 日 | 20,000クレジット($1,000.00のAPI使用)付属 |
| Business | $0.40 | $1,999.00 / 月 月 日 | 40,000クレジット($2,000.00のAPI使用)付属 |
アカウントごとに1つのプラン。3製品でクレジットを共有します。付属クレジットで支払った使用量に追加で課金されることはありません。
現在の価格とプランの制限