Google Maps Ricerca API
Cerca su Google Maps luoghi che corrispondono a una query e a una località: fino a 20 record di luoghi normalizzati con valutazioni, indirizzi e contatti di base per richiesta.
1,40 USD/1k richieste, paghi a richiesta, nessun abbonamento.
Mañana Coffee House
4.6(1,284)
Coffee shop · 612 W 6th St, Austin, TX 78701, USA
{"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY","cid": "8234917364550128200","name": "Mañana Coffee House","url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY","category": "Coffee shop","categories": [...],"address": "612 W 6th St, Austin, TX 78701, USA","street": "612 W 6th St",... 14 campi in più}
Prezzi e provider
Prezzi dell'API Google Maps Ricerca: una sola API, 9 provider intercambiabili
Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.
con tetto di 0,0769 USD a richiesta1 risultato0,0039 USD11 risultati0,0423 USD21 risultatitetto di 0,0769 USDPaghi per ciò che torna indietro. Abbassa il limite per pagare meno - e nessuna singola richiesta può costare più del tetto, per quanto torni indietro.
Provalo
Ottieni Google Maps Ricerca in una sola richiesta
Questo esempio mostra 24 campi su 26. Vedi tutti i campi
{
"found": true,
"data": {
"items": [
{
"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"cid": "8234917364550128200",
"name": "Mañana Coffee House",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Breakfast restaurant",
"Bakery"
],
"address": "612 W 6th St, Austin, TX 78701, USA",
"street": "612 W 6th St",
"city": "Austin",
"state": "Texas",
"postalCode": "78701",
"countryCode": "US",
"latitude": 30.2687,
"longitude": -97.7469,
"phone": "+1 512-555-0142",
"website": "https://mananacoffeeaustin.com",
"rating": 4.6,
"reviewCount": 1284,
"priceLevel": "$$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no"
},
{
"placeId": "ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
"cid": "5127740981263455000",
"name": "Radio Coffee & Beer",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Bar"
],
"address": "4204 Menchaca Rd, Austin, TX 78704, USA",
"street": "4204 Menchaca Rd",
"city": "Austin",
"state": "Texas",
"postalCode": "78704",
"countryCode": "US",
"latitude": 30.2277,
"longitude": -97.7808,
"phone": "+1 512-555-0187",
"website": "https://radiocoffeeandbeer.com",
"rating": 4.7,
"reviewCount": 3021,
"priceLevel": "$$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHRadioCoffeeBeerPatio=w400-h300-k-no"
},
{
"placeId": "ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
"name": "Summer Moon Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
"category": "Coffee shop",
"categories": [
"Coffee shop"
],
"address": "1900 Aldrich St Ste 100, Austin, TX 78723, USA",
"street": "1900 Aldrich St Ste 100",
"city": "Austin",
"state": "Texas",
"postalCode": "78723",
"countryCode": "US",
"latitude": 30.296,
"longitude": -97.7028,
"website": "https://summermooncoffee.com",
"rating": 4.5,
"reviewCount": 642,
"priceLevel": "$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHSummerMoonAldrich=w400-h300-k-no"
}
]
}
}Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.
Riferimento
Una richiesta, una sola forma di risposta.
Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.
Ultima verifica 2026-11-21 · disponibilità e latenza misurate su 30d
Corpo della richiesta
JSON, inviato a questo endpoint.
- locationstring
Austin, TX
Località libera in cui cercare, meglio se città più paese (es. Austin, USA).
- querystring
coffee shop
Ciò che digiteresti nella barra di ricerca di Google Maps (es. coffee shop).
- categoryFilterWordsarray
Elenco facoltativo di nomi di categorie dei luoghi di Google Maps da mantenere; i risultati sono limitati ai luoghi la cui categoria corrisponde a uno di questi. Usa i nomi delle categorie in minuscolo come mostrati su Google Maps (es. ["coffee shop", "restaurant"]). Omettilo per includere tutte le categorie e restare sul prezzo più basso; un filtro per categoria instrada a una fonte più cara.
- languagestring
Codice lingua di due lettere per i risultati (es. en).
- limitinteger
3
Numero massimo di risultati da restituire (1-20, predefinito 20). Il prezzo dipende dal provider selezionato e può essere fisso a richiesta.
- placeMinimumStarsenum
Restituisci solo i luoghi con almeno questa valutazione media: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) o fourAndHalf (4.5+). I luoghi senza recensioni sono esclusi. Omettilo per restare sul prezzo più basso; una soglia di valutazione instrada a una fonte più cara.
- requireFieldsarray
Facoltativo; se lo ometti l'instradamento resta invariato, e serve la fonte più economica. Indica i campi di output che questa richiesta deve poter restituire, per esempio `cid` o `street`, e verrà servita solo da una fonte che li restituisce tutti. I campi che non indichi vengono comunque restituiti ogni volta che la fonte che serve li ha. Può far salire il prezzo: quando la fonte più economica non può restituire un campo indicato, serve una fonte più cara, e ti viene quotato e addebitato il suo prezzo. Un campo indicato può comunque mancare su un luogo che davvero non lo ha. Indicare una combinazione che nessuna singola fonte restituisce insieme viene rifiutato come input non valido, senza addebito.
- websiteenum
Filtra i luoghi in base al fatto che indichino un sito web: allPlaces (predefinito), withWebsite (solo i luoghi che hanno un sito web) o withoutWebsite (solo quelli senza). Omettilo, o invia allPlaces, per restare sul prezzo più basso; withWebsite e withoutWebsite instradano a una fonte più cara.
Risposta
JSON, un valore di esempio per campo.
Matching Google Maps place records. Populated whenever the provider has data for the entity.
- addressstring
612 W 6th St, Austin, TX 78701, USA
Full formatted street address.
- categoriesstring[]
Every Google Maps category listed for the place.
- categorystring
Coffee shop
Primary place category (e.g. Coffee shop).
- cidstringpuò richiedere
8234917364550128200
Google customer/place id (cid).
- citystringpuò richiedere
Austin
City the place is in.
- countryCodestringpuò richiedere
US
Two-letter country code.
- hoursobject[]può richiedere
Opening hours by day: each element is an object with the day name and its hours. null when the serving source does not return hours; name `hours` in `requireFields` to be served by one that does.
- imagestring
https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no
Primary place photo URL.
- latitudenumber
30.2687
Latitude of the place in decimal degrees.
- longitudenumber
-97.7469
Longitude of the place in decimal degrees.
- namestring
Mañana Coffee House
Place name. Populated whenever the provider has data for the entity.
- permanentlyClosedbooleanpuò richiedere
false
True when the place is marked permanently closed.
- phonestring
+1 512-555-0142
Business phone number in E.164 format, when listed.
- placeIdstring
ChIJrX7cX9C1RIYR2LFEjaLyeuY
Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.
- postalCodestringpuò richiedere
78701
Postal code of the place.
- priceLevelstringpuò richiedere
$$
Relative price level indicator (e.g. $, $10-20).
- ratingnumber
4.6
Average star rating out of 5.
- reviewCountnumber
1284
Total number of reviews.
- statestringpuò richiedere
Texas
State or region the place is in.
- streetstringpuò richiedere
612 W 6th St
Street line of the address.
- urlstring
https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY
Canonical Google Maps URL for the place. Populated whenever the provider has data for the entity.
- websitestring
https://mananacoffeeaustin.com
The place's own website URL, when listed.
- foundboolean
true
True when the search returned at least one matching place.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Vendi questa API? Consulta lo schema completo che il tuo endpoint deve restituire.
FAQ
Sull'API Google Maps Ricerca
L'API Google Maps Ricerca di AnyAPI restituisce dati Google Maps come JSON normalizzato da una sola chiamata POST a /v1/run/maps.search. Cerca su Google Maps luoghi che corrispondono a una query e a una località: fino a 20 record di luoghi normalizzati con valutazioni, indirizzi e contatti di base per richiesta. AnyAPI instrada ogni richiesta su 9 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 1,40 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 100,0% delle chiamate Google Maps Ricerca tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,8 secondi su 79.600 chiamate misurate.