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.
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.
{"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}
Tarifs
Tarifs de l’API Google Maps Recherche à proximité
Essayer
Obtenez Google Maps Recherche à proximité en une requê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.
Réponse
JSON, une valeur d’exemple par champ.
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.
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.
- 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.
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.