API di Google Maps

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 - Google Maps
google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo
DirectionsSaveNearbySend to phoneShare

Blue Bottle Coffee

4.4(2,937)·Coffee shop

66 Mint St, San Francisco, CA 94103, USA
Open · Monday 6:30 AM-6:00 PM
+1 415-555-0118
bluebottlecoffee.com
OverviewReviewsAbout
Cosa ha restituito l'APIitems[0]
{
"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ù
}
Disponibilità
100,00%
30d · 187.322 chiamate
Richieste
187.395
30 g · settimanale, ultime 12 sett.
Risposta
2,4s
mediana · 30d

Provalo

Ottieni Google Maps Luogo in una sola richiesta

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.
Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.

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.

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

each itemdata.items[]

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.

top level
  • 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.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

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.

Costa da 0,99 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

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. La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

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. Sono misurazioni di AnyAPI sul traffico che passa dal gateway, ricalcolate di continuo, non un obiettivo di livello di servizio pubblicato.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 101 chiamate Google Maps Luogo a 0,00099 USD ciascuna.

AnyAPI interroga la successiva delle sue 5 fonti nella stessa richiesta, partendo dalla più economica, quindi una fonte che cade non fa fallire la tua chiamata.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/maps.place con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.