Photo du lieu (nouveau)

Sélectionnez une plate-forme: Android iOS Service Web

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:

Essayer

Requê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ètre maxWidthPx, 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/ChIJ2fzCmcW7j4AR2JzfXBBoh6E
Vous 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

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, ni maxWidthPx .
  • La valeur du paramètre maxHeightPx ou maxWidthtPx a été définie à null.
  • Le name a expiré. Si name expire, effectuez une requête envoyée à Place Details (New), Nearby Search (New), ou Text Search (nouvelle version) pour obtenir un nouveau name.

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:

  1. Sélectionnez l'icône API Développez APIs Explorer., sur le côté droit de la page.
  2. Définissez le paramètre name sur: 
    places/PLACE_ID/photos/PHOTO_RESOURCE/media
  3. Définissez skipHttpRedirect sur true 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.
  4. Sélectionnez le bouton Execute (Exécuter). Dans la fenêtre pop-up, sélectionnez le compte utiliser pour effectuer la requête.

  5. Dans le panneau APIs Explorer, sélectionnez l'icône de développement, Développez APIs Explorer., pour développer la fenêtre de l'explorateur d'API.