Place Photo (nouvelle version) est une API en lecture seule qui vous permet d'ajouter du contenu photographique dans votre application. Le service Place Photo offre vous accédez aux millions de photos stockées dans la base de données Places.
Lorsque vous obtenez des informations sur un lieu à l'aide d'une requête Place Details, Nearby Search ou Text Search : vous pouvez également demander des ressources photo pour le contenu photographique approprié. Avec le service Photos, vous pouvez ensuite accéder aux photos référencées et redimensionner l'image à la taille optimale pour votre application.
APIs Explorer vous permet d'effectuer des requêtes en direct afin que vous puissiez vous familiariser avec l'API et la Options d'API:
EssayerRequêtes Place Photo
Une requête Place Photo est une requête HTTP GET envoyée à une URL au format suivant:https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
Lorsque les paramètres suivants sont requis:
- NAME contient le nom de ressource de la photo.
- API_KEY contient la clé API.
- PARAMETERS contient le paramètre
maxHeightPx
, le paramètremaxWidthPx
, ou les deux.
La liste complète des paramètres obligatoires et facultatifs est décrite ci-dessous.
Paramètres obligatoires
Nom de la photo
Identifiant sous forme de chaîne qui identifie une photo de manière unique. Les noms de photos sont renvoyés
Place Details (nouvelle version), Nearby Search (nouvelle version),
ou une requête Text Search (nouvelle version)
dans la propriété name
de chaque élément du tableau photos[]
.
Pour obtenir un exemple, consultez Obtenir un nom de photo.
maxHeightPx et maxWidthPx
Spécifie la hauteur et la largeur maximales souhaitées pour l'image, en pixels. Si l'image est plus petite que les valeurs spécifiées, l'image d'origine est renvoyée. Si l'image est plus grande dimension, elle est mise à l'échelle pour correspondre à la plus petite des deux dimensions, en limitant l'affichage à son format d'origine format. Les propriétés "maxheight" et "maxwidth" acceptent un nombre entier compris entre 1 et 4 800.
Vous devez spécifier maxHeightPx
, maxWidthPx
ou les deux.
Paramètres facultatifs
skipHttpRedirect
Si la valeur est false
(valeur par défaut), effectuez une redirection HTTP vers l'image pour la renvoyer.
Si la valeur est true
, ignorez la redirection et renvoyez une réponse JSON contenant les détails de l'image.
Exemple :
{ "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media", "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" }
Cette option est ignorée pour les requêtes autres que HTTP.
Obtenir un nom de photo
Toutes les requêtes envoyées au service Place Photo doivent inclure un
nom de ressource photo, renvoyé dans la réponse à une requête Nearby Search, Text Search ou
Requête Place Details. La réponse à ces requêtes contient un tableau photos[]
si le
lieu associé à des photos.
Chaque élément de photo[]
contient les champs suivants:
name
: chaîne contenant le nom de ressource de la photo lorsque vous envoyer une requête de photo. Cette chaîne se présente sous la forme:places/PLACE_ID/photos/PHOTO_RESOURCE
heightPx
: hauteur maximale de l'image, en pixels.widthPx
: largeur maximale de l'image, en pixels.authorAttributions[]
: attributions requises. Ce est toujours présent, mais peut être vide.
Les photos renvoyées par le service Photo
proviennent de différents endroits,
y compris les propriétaires d'établissement et les photos ajoutées par les utilisateurs. Dans la plupart des cas, ces
photos peuvent être utilisées sans attribution ou comporteront l'attribution requise
incluses dans l'image. Toutefois, si l'élément photo
renvoyé
inclut une valeur dans le champ authorAttributions
, vous devez inclure le paramètre
une attribution supplémentaire dans votre application, partout où vous affichez l'image.
L'exemple suivant montre une requête Place Details incluant photos
dans
le masque de champ afin que la réponse comprenne le tableau photos[]
:
curl -X GET \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,photos" \ https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6EVous trouverez ci-dessous un exemple de tableau
photos[]
dans la réponse.
... "photos" : [ { "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1", "widthPx": 6000, "heightPx": 4000, "authorAttributions": [ { "displayName": "John Smith", "uri": "//maps.google.com/maps/contrib/101563", "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" } ] }, ...
Demander une photo de lieu
L'exemple de requête ci-dessous renvoie une image à l'aide de sa ressource name
, en la redimensionnant pour qu'elle
qu'elle ne fasse pas plus de 400 pixels de hauteur et de largeur:
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
La réponse d'une requête Place Photo réussie est une image. Le type de l'image dépend du type de la photo envoyée à l'origine.
Si votre demande dépasse votre quota disponible, le serveur renvoie une l'état HTTP 403 et affichez l'image ci-dessous pour indiquer que le quota ont été dépassés:
![Image Dépassement du quota](https://developers.google.cn/static/maps/documentation/maps-static/images/quota.png?authuser=8&hl=fr)
Si le serveur ne comprend pas votre requête, il renvoie le code HTTP 400 , qui indique une requête non valide. Les raisons les plus courantes d'une les requêtes incorrectes incluent:
- Le nom de la photo envoyée n'a pas été spécifié correctement.
- La requête n'incluait ni
maxHeightPx
, nimaxWidthPx
. - La valeur du paramètre
maxHeightPx
oumaxWidthtPx
a été définie ànull
. - Le
name
a expiré. Siname
expire, effectuez une requête envoyée à Place Details (New), Nearby Search (New), ou Text Search (nouvelle version) pour obtenir un nouveauname
.
Essayer
APIs Explorer vous permet de créer des exemples de requêtes afin de vous familiariser avec l'API et ses options.
Pour envoyer une demande:
- Sélectionnez l'icône API
, sur le côté droit de la page.
- Définissez le paramètre
name
sur:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- Définissez
skipHttpRedirect
surtrue
pour que la requête renvoie un fichier JSON de réponse. Par défaut, la requête renvoie l'image, qui ne peut pas être affichée par APIs Explorer. - Sélectionnez le bouton Execute (Exécuter). Dans la fenêtre pop-up, sélectionnez le compte utiliser pour effectuer la requête.
Dans le panneau APIs Explorer, sélectionnez l'icône de développement,
, pour développer la fenêtre de l'explorateur d'API.