Le service Place Photo, qui fait partie de l'API Places, est un service qui vous permet d'ajouter du contenu photographique de haute qualité application. Le service Place Photo vous permet d'accéder à des millions de photos. stockées dans la base de données Places. Lorsque vous obtenez des informations sur un lieu à l'aide d'un objet Place Demande de détails. Les références photo seront renvoyées pour les photographies pertinentes. contenus. Les requêtes Find Place, Nearby Search et Text Search renvoient également une seule photo référence par lieu, le cas échéant. Le service Photo vous permet ensuite d'accéder photos référencées et redimensionner l'image à la taille optimale pour votre application.
Requêtes Place Photo
Une requête de photos de lieu est une URL HTTP utilisant le format suivant :
https://maps.googleapis.com/maps/api/place/photo?parameters
Certains paramètres sont obligatoires pour lancer une requête de recherche. Comme d'habitude
Dans les URL, tous les paramètres sont séparés par une esperluette (&
). La
les paramètres et leurs valeurs possibles sont énumérés ci-dessous.
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
maxheight or maxwidth
maxheight
specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.maxwidth
specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
Références de photos
Toutes les requêtes envoyées au service Place Photo doivent inclure un champ photo_reference
,
renvoyées dans la réponse à une requête Find Place, Nearby Search, Text Search ou Place Details
requête. La réponse à ces requêtes contient un champ photos[]
si le
lieu associé à des photos.
Remarque : Le nombre de photos renvoyées varie en fonction de la requête.
- Une requête Find Place, Nearby Search ou Text Search renvoie au maximum un élément
photo
dans le tableau. - Une requête Place Details renvoie jusqu'à 10 éléments
photo
.
Chaque élément photo
contient les champs suivants:
photo_reference
: chaîne permettant d'identifier la photo lorsque vous envoyer une requête de photo.height
: hauteur maximale de l'image.width
: largeur maximale de l'image.html_attributions[]
: contient les 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 html_attributions
, vous devez inclure le paramètre
une attribution supplémentaire dans votre application, partout où vous affichez l'image.
L'exemple suivant illustre une requête Place Details:
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
Vous trouverez ci-dessous un exemple de tableau photos[]
dans la réponse.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}
...
Exemple de Place Photo
Voici un exemple de requête. Cette requête renvoie l'ID en la redimensionnant pour qu'elle ne dépasse pas 400 pixels de largeur.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
Réponse Place Photo
La réponse à une requête de photos de lieu valide est une image. Le type 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:
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:
- La référence photo envoyée n'a pas été spécifiée correctement.
- La requête n'incluait ni
maxwidth
, nimaxheight
paramètres. - La valeur du paramètre
maxwidth
oumaxheight
a été définie ànull
. - Le
photo_reference
a expiré. Siphoto_reference
expire, effectuez une à Place Details, Find Place Nearby Search, ou Recherche textuelle pour obtenir la valeurphoto_reference
mise à jour.