Google Maps Lieu API
Recherchez un lieu sur Google Maps par nom ou requête de recherche (éventuellement limitée à un lieu) et obtenez le lieu le plus pertinent avec l’adresse, le contact, la note et les coordonnées disponibles, en JSON normalisé.
0,99 $US/1k req, paiement à la requête, sans abonnement.
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 champs de plus}
Tarifs et fournisseurs
Tarifs de l’API Google Maps Lieu : une API, 5 fournisseurs interchangeables
Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.
plafonné à 0,0108 $US par requête1 résultat0,0096 $US2 résultatsplafond de 0,0108 $USVous payez ce qui vous revient. Baissez la limite pour payer moins - et aucune requête ne peut coûter plus que le plafond, quelle que soit la quantité renvoyée.
Essayer
Obtenez Google Maps Lieu en une requête
Cet exemple affiche 26 champs sur 27. Voir tous les champs
{
"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"
}
]
}
]
}
}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.
- querystring
Blue Bottle Coffee
Nom de l’entreprise ou texte de recherche à rechercher, tel que vous le saisiriez dans la barre de recherche de Google Maps (p. ex. Blue Bottle Coffee).
- categoryFilterWordsarray
Liste facultative de noms de catégories de lieux Google Maps à conserver ; la correspondance est limitée à un lieu dont la catégorie en fait partie. Utilisez les noms de catégorie en minuscules tels qu’affichés sur Google Maps (p. ex. ["coffee shop"]). Omettez pour accepter n’importe quelle catégorie et rester au prix le plus bas ; un filtre par catégorie route vers une source plus chère.
- languagestring
Code de langue à deux lettres pour les détails des résultats (p. ex. en).
- locationstring
San Francisco, CA
Lieu libre facultatif pour cadrer la recherche, idéalement ville plus État ou pays (p. ex. San Francisco, CA). Restreint la requête à la meilleure correspondance dans cette zone.
- placeMinimumStarsenum
Ne correspond qu’à un lieu ayant au moins cette note moyenne : two (2+), twoAndHalf (2,5+), three (3+), threeAndHalf (3,5+), four (4+) ou fourAndHalf (4,5+). Les lieux sans avis sont exclus. Omettez ce champ pour rester au prix le plus bas ; un seuil de note route vers une source plus chère.
- 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
Filtre selon que le lieu indique un site web ou non : allPlaces (par défaut), withWebsite (seulement s’il a un site web) ou withoutWebsite (seulement s’il n’en a pas). Omettez ce champ, ou envoyez allPlaces, pour rester au prix le plus bas ; withWebsite et withoutWebsite routent vers une source plus chère.
Réponse
JSON, une valeur d’exemple par champ.
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.
- citystringpeut exiger
San Francisco
- countryCodestringpeut exiger
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.
- neighborhoodstringpeut exiger
SoMa
- permanentlyClosedbooleanpeut exiger
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.
- plusCodestringpeut exiger
QHGX+59 San Francisco, California
Google Plus Code for the location.
- postalCodestringpeut exiger
94103
- priceLevelstring
$$
Price level indicator (e.g. a price range).
- ratingnumber
4.4
Average star rating.
- reviewsCountinteger
2937
Total number of reviews.
- statestringpeut exiger
California
State or region name.
- streetstringpeut exiger
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.
Vous vendez cette API ? Consultez le schéma complet que votre endpoint doit renvoyer.
FAQ
À propos de l’API Google Maps Lieu
L’API Google Maps Lieu d’AnyAPI renvoie des données Google Maps en JSON normalisé à partir d’un appel POST à /v1/run/maps.place. Recherchez un lieu sur Google Maps par nom ou requête de recherche (éventuellement limitée à un lieu) et obtenez le lieu le plus pertinent avec l’adresse, le contact, la note et les coordonnées disponibles, en JSON normalisé. AnyAPI route chaque requête sur 5 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 0,99 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 100,0% des appels Google Maps Lieu passés par AnyAPI ont réussi, avec un temps de réponse médian de 2,4 secondes, sur 187 322 appels mesurés.