Google Maps place results for a query — rating, address
serpapi.x.google-mapsLive Google Maps place results for a keyword and location, or a Google place_id lookup — position, place_id, rating, address, phone, website
- Price
- $0.015/successPelo preço do provedor
- Success rate
- 100%Last 30 days · 13.370 calls
- Latency p50
- 1.1 sp95 4.1 s
- Last verified
- 28 de jul. de 2026Verified working
GEThttps://toolswitch.dev/v1/tools/serpapi.x.google-maps?q=pizza&ll=%4040.7455096%2C-74.0083012%2C14z&type=search&engine=google_mapsPreview- Uses platform quota
- Synchronous response
- Reads public data
Parâmetros
Keyword search answers arrive in `local_results`; a place_id lookup answers in `place_results`. Search: engine=google_maps type=search q=pizza ll=@…. Place lookup: engine=google_maps type=place q=<place name or place_id> place_id=ChIJifIePKtZwokRVZ-UdRGkZzs.
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Parâmetros de consulta | ||||
q | string | Obrigatório | required for type=search (keyword). For a place_id lookup, Treg still requires q — send the place name, or the same place_id as q, alongside place_id. | pizza |
ll | string | Opcional | @latitude,longitude,zoom — alternative to location+z or lat/lon+z | @40.7455096,-74.0083012,14z |
type | string | Obrigatório | search (keyword list) or place (single-place lookup via place_id). Prefer type=place with place_id. Upstream does not require type when place_id is set (https://serpapi.com/google-maps-api); Treg still requires type — send type=place for a place_id lookup. | search |
start | inteiro | Opcional | pagination offset, increments of 20 | 0 |
engine | string | Obrigatório | google_maps | |
place_id | string | Opcional | Google place_id for a single-place lookup / NAP (name, address, phone, website). Prefer with type=place. Upstream accepts place_id without other optional params (https://serpapi.com/google-maps-api); Treg still requires type and q, so send type=place and a q (place name, or place_id as q) alongside place_id. | ChIJifIePKtZwokRVZ-UdRGkZzs |
- Parâmetros de consulta
qstringObrigatóriorequired for type=search (keyword). For a place_id lookup, Treg still requires q — send the place name, or the same place_id as q, alongside place_id.
Exemplo:
pizzallstringOpcional@latitude,longitude,zoom — alternative to location+z or lat/lon+z
Exemplo:
@40.7455096,-74.0083012,14ztypestringObrigatóriosearch (keyword list) or place (single-place lookup via place_id). Prefer type=place with place_id. Upstream does not require type when place_id is set (https://serpapi.com/google-maps-api); Treg still requires type — send type=place for a place_id lookup.
Exemplo:
searchstartinteiroOpcionalpagination offset, increments of 20
Exemplo:
0enginestringObrigatórioExemplo:
google_mapsplace_idstringOpcionalGoogle place_id for a single-place lookup / NAP (name, address, phone, website). Prefer with type=place. Upstream accepts place_id without other optional params (https://serpapi.com/google-maps-api); Treg still requires type and q, so send type=place and a q (place name, or place_id as q) alongside place_id.
Exemplo:
ChIJifIePKtZwokRVZ-UdRGkZzs
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
curl -X GET 'https://toolswitch.dev/v1/tools/serpapi.x.google-maps?q=pizza&ll=%4040.7455096%2C-74.0083012%2C14z&type=search&engine=google_maps' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/serpapi.x.google-maps?q=pizza&ll=%4040.7455096%2C-74.0083012%2C14z&type=search&engine=google_maps",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/serpapi.x.google-maps?q=pizza&ll=%4040.7455096%2C-74.0083012%2C14z&type=search&engine=google_maps", {
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());Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.015/success, incluindo a taxa de serviço.