Google Maps Luogo API
Cerca un luogo su Google Maps per nome o query di ricerca (facoltativamente limitata a una località) e ottieni il luogo più corrispondente con indirizzo, contatti, valutazione e coordinate disponibili come JSON normalizzato.
0,99 USD/1k richieste, paghi a richiesta, nessun abbonamento.
Blue Bottle Coffee
4.4(2,937)·Coffee shop
{"name": "Blue Bottle Coffee","url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo","placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo","address": "66 Mint St, San Francisco, CA 94103, USA","street": "66 Mint St","city": "San Francisco","state": "California","postalCode": "94103",... 15 campi in più}
Prezzi e provider
Prezzi dell'API Google Maps Luogo: una sola API, 5 provider intercambiabili
Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.
con tetto di 0,0108 USD a richiesta1 risultato0,0096 USD2 risultatitetto di 0,0108 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 Luogo in una sola richiesta
Questo esempio mostra 26 campi su 27. Vedi tutti i campi
{
"found": true,
"data": {
"items": [
{
"name": "Blue Bottle Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
"placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
"address": "66 Mint St, San Francisco, CA 94103, USA",
"street": "66 Mint St",
"city": "San Francisco",
"state": "California",
"postalCode": "94103",
"countryCode": "US",
"neighborhood": "SoMa",
"phone": "+1 415-555-0118",
"website": "https://bluebottlecoffee.com",
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Cafe",
"Espresso bar"
],
"rating": 4.4,
"reviewsCount": 2937,
"latitude": 37.7825,
"longitude": -122.4058,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no",
"priceLevel": "$$",
"plusCode": "QHGX+59 San Francisco, California",
"permanentlyClosed": false,
"hours": [
{
"day": "Monday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Tuesday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Wednesday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Thursday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Friday",
"hours": "6:30 AM-6:00 PM"
},
{
"day": "Saturday",
"hours": "7:00 AM-6:00 PM"
},
{
"day": "Sunday",
"hours": "7:00 AM-5:00 PM"
}
]
}
]
}
}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.
- querystring
Blue Bottle Coffee
Nome dell'attività o testo di ricerca da cercare, come lo digiteresti nella barra di ricerca di Google Maps (es. Blue Bottle Coffee).
- categoryFilterWordsarray
Elenco facoltativo di nomi di categorie dei luoghi di Google Maps da mantenere; la corrispondenza è limitata a un luogo la cui categoria è una di queste. Usa i nomi delle categorie in minuscolo come mostrati su Google Maps (es. ["coffee shop"]). Omettilo per consentire qualsiasi categoria e restare sul prezzo più basso; un filtro per categoria instrada a una fonte più cara.
- languagestring
Codice lingua di due lettere per i dettagli dei risultati (es. en).
- locationstring
San Francisco, CA
Località in testo libero facoltativa per delimitare la ricerca, meglio se città più stato o paese (es. San Francisco, CA). Restringe la query alla corrispondenza migliore in quell'area.
- placeMinimumStarsenum
Cerca solo 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
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
- websiteenum
Filtra in base al fatto che il luogo indichi un sito web: allPlaces (predefinito), withWebsite (solo se ha un sito web) o withoutWebsite (solo se non ne ha). 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.
The best-matching place for the query, with available address, contact, category, rating, opening-hours, and coordinate details. Up to one element (empty when nothing matched). Populated whenever the provider has data for the entity.
- addressstring
66 Mint St, San Francisco, CA 94103, USA
Full formatted street address. Populated whenever the provider has data for the entity.
- categoriesstring[]
Every Google Maps category listed for the place.
- categorystring
Coffee shop
Primary Google Maps category (e.g. Coffee shop). Populated whenever the provider has data for the entity.
- citystringpuò richiedere
San Francisco
- countryCodestringpuò richiedere
US
Two-letter country code.
- hoursobject[]
Opening hours by day: each element is an object with the day name and its hours.
- imagestring
https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no
URL of the primary place photo.
- latitudenumber
37.7825
Populated whenever the provider has data for the entity.
- longitudenumber
-122.4058
Populated whenever the provider has data for the entity.
- namestring
Blue Bottle Coffee
Business or place name. Populated whenever the provider has data for the entity.
- neighborhoodstringpuò richiedere
SoMa
- permanentlyClosedbooleanpuò richiedere
false
Whether the place is permanently closed.
- phonestring
+1 415-555-0118
Formatted phone number.
- placeIdstring
ChIJd7DoQL2AhYARW-mNQFPuGZo
Google Maps place id. Populated whenever the provider has data for the entity.
- plusCodestringpuò richiedere
QHGX+59 San Francisco, California
Google Plus Code for the location.
- postalCodestringpuò richiedere
94103
- priceLevelstring
$$
Price level indicator (e.g. a price range).
- ratingnumber
4.4
Average star rating.
- reviewsCountinteger
2937
Total number of reviews.
- statestringpuò richiedere
California
State or region name.
- streetstringpuò richiedere
66 Mint St
Street portion of the address.
- urlstring
https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo
Google Maps URL for the place. Populated whenever the provider has data for the entity.
- websitestring
https://bluebottlecoffee.com
Business website URL.
- foundboolean
true
- 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 Luogo
L'API Google Maps Luogo di AnyAPI restituisce dati Google Maps come JSON normalizzato da una sola chiamata POST a /v1/run/maps.place. Cerca un luogo su Google Maps per nome o query di ricerca (facoltativamente limitata a una località) e ottieni il luogo più corrispondente con indirizzo, contatti, valutazione e coordinate disponibili come JSON normalizzato. AnyAPI instrada ogni richiesta su 5 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 0,99 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 Luogo tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,4 secondi su 187.322 chiamate misurate.