API Google Maps

Google Maps Recherche à proximité API

Cherchez sur Google Maps autour d’une latitude et d’une longitude exactes et obtenez jusqu’à 20 lieux normalisés par appel, chacun avec l’adresse décomposée en rue, ville, État, code postal et pays. À utiliser quand vous avez des coordonnées et voulez la fenêtre de la carte centrée dessus ; utilisez maps.search quand vous n’avez qu’un nom de lieu. Repassez le nextCursor renvoyé dans cursor pour les 20 lieux suivants.

1,30 $US/1k req, paiement à la requête, sans abonnement.

coffee shop - Google Maps
google.com/maps/search/coffee%20shop/@30.2672, -97.7431,15z
coffee shop
ResultsShare

Mañana Coffee House

4.6(1,284)

Coffee shop · 612 W 6th St, Austin, TX 78701, USA

Cozy cafe serving pour-over coffee and pastries a few blocks from the Capitol.

Update results when map moves
Mañana Coffee House
Google Maps
Ce que l’API a renvoyéitems[0]
{
"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",
... 15 champs de plus
}
Disponibilité
99,77%
30d · 4 352 appels
Requêtes
4 355
30 j · par semaine, 12 dernières sem.
Réponse
6,1s
médiane · 30d

Tarifs

Tarifs de l’API Google Maps Recherche à proximité

Vous payez
13,00 $US
1,30 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 76 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Google Maps Recherche à proximité en une requête

Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.

Cet exemple affiche 27 champs sur 28. Voir tous les champs

{
  "found": true,
  "data": {
    "nextCursor": "eyJvZmZzZXQiOjMsInEiOiJjb2ZmZWUgc2hvcCJ9",
    "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"
        ],
        "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,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w200-h150-k-no",
        "neighborhood": "Downtown",
        "domain": "mananacoffeeaustin.com",
        "description": "Cozy cafe serving pour-over coffee and pastries a few blocks from the Capitol.",
        "rank": 1
      },
      {
        "placeId": "ChIJTUxDowe1RIYRy5j2Vd8HwKg",
        "name": "Cuvee Coffee Roastery",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJTUxDowe1RIYRy5j2Vd8HwKg",
        "category": "Coffee roasters",
        "categories": [
          "Coffee roasters",
          "Coffee shop"
        ],
        "address": "2000 Justin Ln, Austin, TX 78757, USA",
        "street": "2000 Justin Ln",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78757",
        "countryCode": "US",
        "latitude": 30.3335,
        "longitude": -97.7231,
        "website": "https://cuveecoffee.com",
        "rating": 4.4,
        "reviewCount": 511,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHCuveeRoastery=w200-h150-k-no",
        "neighborhood": "Crestview",
        "domain": "cuveecoffee.com",
        "rank": 2
      },
      {
        "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,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHSummerMoonAldrich=w200-h150-k-no",
        "neighborhood": "Mueller",
        "domain": "summermooncoffee.com",
        "rank": 3
      }
    ]
  }
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet endpoint.

  • coordinatesobject

    {"latitude":30.2672,"longitude":-97.7431}

    Centre exact de la carte autour duquel chercher. Utilisez plutôt maps.search si vous n’avez qu’un nom de lieu.

  • querystring

    coffee shop

    Ce que vous saisiriez dans la barre de recherche de Google Maps (p. ex. coffee shop).

  • cursorstring

    Curseur opaque issu du nextCursor d’une réponse précédente. Repassez-le pour obtenir la page suivante de lieux.

  • languagestring

    Code de langue à deux lettres pour les résultats (p. ex. en).

  • limitinteger

    3

    Accepted but does not change the page: every call returns one full Google Maps viewport of about 20 places, never trimmed, so nextCursor continues exactly where this response ended. Price is flat per request.

  • zoomnumber

    Zoom de la fenêtre Google Maps. Une valeur plus basse couvre une zone plus large, une plus haute se concentre plus étroitement autour des coordonnées.

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

each itemdata.items[]

Matching Google Maps place records, nearest the requested coordinates first. 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).

  • cidstring

    8234917364550128200

    Google customer/place id (cid).

  • citystring

    Austin

    City the place is in.

  • countryCodestring

    US

    Two-letter country code.

  • descriptionstring

    Cozy cafe serving pour-over coffee and pastries a few blocks from the Capitol.

    Google's one-line description of the place.

  • domainstring

    mananacoffeeaustin.com

    Registrable domain of the place website.

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w200-h150-k-no

    Thumbnail photo URL for the place.

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

  • neighborhoodstring

    Downtown

    Neighborhood the place is in.

  • phonestring

    +1 512-555-0142

    Business phone number, when listed.

  • placeIdstring

    ChIJrX7cX9C1RIYR2LFEjaLyeuY

    Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.

  • postalCodestring

    78701

    Postal code of the place.

  • rankinteger

    1

    One-based position of the place in the Google Maps result order.

  • ratingnumber

    4.6

    Average Google rating out of 5.

  • reviewCountinteger

    1284

    Number of Google reviews the place has.

  • statestring

    Texas

    State or region the place is in, spelled in full (e.g. Texas).

  • streetstring

    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.

datadata

The result wrapper, or null when nothing matched.

  • nextCursorstring

    eyJvZmZzZXQiOjMsInEiOiJjb2ZmZWUgc2hvcCJ9

    Opaque cursor for the next page of places, or null when this search is complete. Pass it back as cursor to continue.

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

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

FAQ

À propos de l’API Google Maps Recherche à proximité

L’API Google Maps Recherche à proximité d’AnyAPI renvoie des données Google Maps en JSON normalisé à partir d’un appel POST à /v1/run/maps.search_nearby. Cherchez sur Google Maps autour d’une latitude et d’une longitude exactes et obtenez jusqu’à 20 lieux normalisés par appel, chacun avec l’adresse décomposée en rue, ville, État, code postal et pays. À utiliser quand vous avez des coordonnées et voulez la fenêtre de la carte centrée dessus ; utilisez maps.search quand vous n’avez qu’un nom de lieu. Repassez le nextCursor renvoyé dans cursor pour les 20 lieux suivants. AnyAPI renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte à partir de 1,30 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 99,8% des appels Google Maps Recherche à proximité passés par AnyAPI ont réussi, avec un temps de réponse médian de 6,1 secondes, sur 4 352 appels mesurés.

Elle coûte à partir de 1,30 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

Cherchez sur Google Maps autour d’une latitude et d’une longitude exactes et obtenez jusqu’à 20 lieux normalisés par appel, chacun avec l’adresse décomposée en rue, ville, État, code postal et pays. À utiliser quand vous avez des coordonnées et voulez la fenêtre de la carte centrée dessus ; utilisez maps.search quand vous n’avez qu’un nom de lieu. Repassez le nextCursor renvoyé dans cursor pour les 20 lieux suivants. La réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Ces 30 derniers jours, 99,8% des appels Google Maps Recherche à proximité passés par AnyAPI ont réussi, avec un temps de réponse médian de 6,1 secondes, sur 4 352 appels mesurés. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 76 appels Google Maps Recherche à proximité à 0,0013 $US chacun.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/maps.search_nearby avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.