Search Google Maps
litescrape.google.serp.mapsSearch Google Maps with q and type=search to get up to 20 places in local_results, or look up one exact place by place_id, data_cid or data to get place_results
- Price
- $0.00015/successプロバイダー原価
- Success rate
- 96.1%Last 30 days · 904,703 calls
- Latency p50
- 6.4 sp95 16 s
- Last verified
- 2026/09/29Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=searchPreview- Uses platform quota
- Synchronous response
- Reads public data
パラメータ
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| クエリパラメータ | ||||
m | 数値 | 任意 | Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z. | |
q | 文字列 | 任意 | Search query, such as coffee shops in Austin, TX. Required when type=search. A search needs one of q, place_id, data_cid or data. | coffee shops in Austin, TX |
z | 数値 | 任意 | Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m. | |
gl | 文字列 | 任意 | Two-letter country code used to localize results. Defaults to us. | us |
hl | 文字列 | 任意 | Language code such as en, en-GB, or de. | en |
ll | 文字列 | 任意 | Map viewport as @latitude,longitude,zoomz or @latitude,longitude,radiusm, for example @30.2672,-97.7431,14z. Already includes its scale, so do not add z or m. Mutually exclusive with location and lat/lon. | @30.2672,-97.7431,14z |
lat | 数値 | 任意 | Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location. | |
lon | 数値 | 任意 | Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location. | |
data | 文字列 | 任意 | Google Maps protobuf sequence copied from a Maps URL, beginning with ! and at most 8,192 characters. A sequence that identifies one place requires type=place and is mutually exclusive with place_id and data_cid. | |
type | 文字列 | 任意 | search returns a list of places in local_results; place returns one exact place in place_results. Required when searching by q or by filter data, and type=place is required with an exact-place data sequence. Can be omitted with place_id or data_cid. | search |
start | 整数 | 任意 | Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response. | |
nearby | 真偽値 | 任意 | Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon. | |
timeout | 数値 | 任意 | Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline. | |
data_cid | 文字列 | 任意 | Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence. | |
location | 文字列 | 任意 | Human-readable location to center the map on, such as Austin, Texas. Requires z or m. Mutually exclusive with ll and lat/lon. | Austin, Texas, United States |
place_id | 文字列 | 任意 | Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence. | ChIJT2h1HKZZwokR0kgzEtsa03k |
max_price | 整数 | 任意 | Maximum Google price level, a non-negative integer. Must be at least min_price. | |
min_price | 整数 | 任意 | Minimum Google price level, a non-negative integer. Must not exceed max_price. | |
min_rating | 数値 | 任意 | Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear. | |
open_state | 文字列 | 任意 | now returns places open now; 24h returns places open 24 hours. Cannot be combined with open_on_day or open_at_hour. | |
open_on_day | 文字列 | 任意 | Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state. | |
open_at_hour | 整数 | 任意 | Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state. | |
google_domain | 文字列 | 任意 | Google domain used for the request. | google.com |
- クエリパラメータ
m数値任意Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z.
q文字列任意Search query, such as coffee shops in Austin, TX. Required when type=search. A search needs one of q, place_id, data_cid or data.
例:
coffee shops in Austin, TXz数値任意Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.
gl文字列任意Two-letter country code used to localize results. Defaults to us.
例:
ushl文字列任意Language code such as en, en-GB, or de.
例:
enll文字列任意Map viewport as @latitude,longitude,zoomz or @latitude,longitude,radiusm, for example @30.2672,-97.7431,14z. Already includes its scale, so do not add z or m. Mutually exclusive with location and lat/lon.
例:
@30.2672,-97.7431,14zlat数値任意Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location.
lon数値任意Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location.
data文字列任意Google Maps protobuf sequence copied from a Maps URL, beginning with ! and at most 8,192 characters. A sequence that identifies one place requires type=place and is mutually exclusive with place_id and data_cid.
type文字列任意search returns a list of places in local_results; place returns one exact place in place_results. Required when searching by q or by filter data, and type=place is required with an exact-place data sequence. Can be omitted with place_id or data_cid.
例:
searchstart整数任意Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response.
nearby真偽値任意Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon.
timeout数値任意Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
data_cid文字列任意Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.
location文字列任意Human-readable location to center the map on, such as Austin, Texas. Requires z or m. Mutually exclusive with ll and lat/lon.
例:
Austin, Texas, United Statesplace_id文字列任意Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.
例:
ChIJT2h1HKZZwokR0kgzEtsa03kmax_price整数任意Maximum Google price level, a non-negative integer. Must be at least min_price.
min_price整数任意Minimum Google price level, a non-negative integer. Must not exceed max_price.
min_rating数値任意Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear.
open_state文字列任意now returns places open now; 24h returns places open 24 hours. Cannot be combined with open_on_day or open_at_hour.
open_on_day文字列任意Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.
open_at_hour整数任意Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.
google_domain文字列任意Google domain used for the request.
例:
google.com
コード例
$TOOLSWITCH_KEY をコンソールで作成したキーに置き換えてください。
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=search' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=search",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=search", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は $0.00015/success です。サービス料を含みます。