Questa pagina è stata tradotta dall'API Cloud Translation.

Foto del luogo (nuova)

Seleziona la piattaforma: Android iOS Web Service

Il servizio Place Photo (New) è un'API di sola lettura che consente di aggiungere contenuti fotografici di alta qualità alla tua applicazione. Il servizio Place Photo ti dà accesso ai milioni di foto archiviate nel database di Places.

Quando ricevi informazioni su un luogo tramite una richiesta Place Details, Nearby Search o Text Search, puoi anche richiedere risorse fotografiche per contenuti fotografici pertinenti. Tramite il servizio Foto puoi quindi accedere alle foto di riferimento e ridimensionarle in base alle dimensioni ottimali per la tua applicazione.

Explorer API ti consente di effettuare richieste in tempo reale per acquisire familiarità con l'API e le relative opzioni:

Prova!

Richieste foto luogo

Una richiesta Place Photo è una richiesta GET HTTP a un URL nel formato:

https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Dove sono obbligatori i seguenti parametri:

NAME contiene il nome risorsa della foto.
API_KEY contiene la chiave API.
PARAMETERS contiene il parametro maxHeightPx, il parametro maxWidthPx o entrambi.

L'elenco completo dei parametri obbligatori e facoltativi è descritto di seguito.

Parametri obbligatori

Nome foto

Un identificatore di stringa che identifica in modo univoco una foto. I nomi delle foto vengono restituiti da una richiesta Place Details (Nuova), Nearby Search (New) o Text Search (New) nella proprietà name di ogni elemento dell'array photos[].

Per un esempio, vedi Scegliere il nome di una foto.

maxHeightPx e maxwidthPx

Specifica l'altezza e la larghezza massime desiderate, in pixel, dell'immagine. Se l'immagine è più piccola rispetto ai valori specificati, verrà restituita l'immagine originale. Se l'immagine è più grande di una delle due dimensioni, verrà ridimensionata in modo da corrispondere alla più piccola delle due dimensioni, limitatamente alle proporzioni originali. Entrambe le proprietà maxheight e maxwidth accettano un numero intero compreso tra 1 e 4800.

Devi specificare maxHeightPx, maxWidthPx o entrambi.

Parametri facoltativi

skipHttpRedirect

Se false (impostazione predefinita), esegui un reindirizzamento HTTP all'immagine per restituirla. Se true, salta il reindirizzamento e restituisci una risposta JSON contenente l'immagine non conforme. Ad esempio:

{
  "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media",
  "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
}

Questa opzione viene ignorata per le richieste non HTTP.

Ottieni un nome per la foto

Tutte le richieste al servizio Place Photo devono includere il nome risorsa di una foto, restituito nella risposta a una richiesta Nearby Search, Text Search o Place Details. La risposta a queste richieste contiene un array photos[] se il luogo ha contenuti fotografici correlati.

Nota: per includere l'array photos[] nella risposta, assicurati di includere photos (Place Details) o places.photos (Nearby Search and Text Search) nella maschera dei campi della richiesta. Ogni API può restituire fino a 10 foto per la posizione di un luogo.

Ogni elemento di photo[] contiene i seguenti campi:

name: una stringa contenente il nome della risorsa della foto quando esegui una richiesta di foto. Questa stringa ha il formato:
```
places/PLACE_ID/photos/PHOTO_RESOURCE
```
heightPx: l'altezza massima dell'immagine, in pixel.
widthPx: la larghezza massima dell'immagine, in pixel.
authorAttributions[]: eventuali attribuzioni obbligatorie. Questo campo è sempre presente, ma potrebbe essere vuoto.

Le foto restituite dal servizio Foto provengono da diverse località, tra cui i proprietari delle attività e le foto fornite dagli utenti. Nella maggior parte dei casi, queste foto possono essere utilizzate senza attribuzione o avranno l'attribuzione richiesta inclusa all'interno dell'immagine. Tuttavia, se l'elemento photo restituito include un valore nel campo authorAttributions, devi includere l'attribuzione aggiuntiva nella tua applicazione ovunque mostri l'immagine.

L'esempio seguente mostra una richiesta Place Details che include photos nella maschera del campo in modo che la risposta includa l'array photos[] nella risposta:

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

Di seguito è riportato un esempio di array photos[] nella risposta.

    ...
    "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"
          }
        ]
      },    ...

Richiedi una foto del luogo

La richiesta di esempio riportata di seguito restituisce un'immagine utilizzando la risorsa name, ridimensionandola in modo che abbia un'altezza e una larghezza di massimo 400 pixel:

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 risposta a una richiesta di Place Photo andata a buon fine è un'immagine. Il tipo di immagine dipende dal tipo di foto inviata inizialmente.

Se la richiesta supera la quota disponibile, il server restituisce uno stato HTTP 403 e visualizza l'immagine seguente per indicare che la quota è stata superata:

Se il server non è in grado di comprendere la richiesta, restituisce lo stato HTTP 400, che indica una richiesta non valida. I motivi più comuni di una richiesta non valida includono:

Il nome della foto inviata non è stato specificato correttamente.
La richiesta non includeva il parametro maxHeightPx o maxWidthPx.
Il valore del parametro maxHeightPx o maxWidthtPx è stato impostato su null.
L'offerta name è scaduta. Se name scade, invia una richiesta a Place Details (Nuova), Ricerca nelle vicinanze (nuova) o Ricerca testuale (nuova) per ottenere un nuovo name.

Prova.

Explorer API consente di effettuare richieste di esempio, per acquisire familiarità con le opzioni API e API.

Per effettuare una richiesta:

Seleziona l'icona dell'API sul lato destro della pagina.
Imposta il parametro name su:
```
places/PLACE_ID/photos/PHOTO_RESOURCE/media
```
Nota: assicurati di utilizzare un elemento name di una richiesta Dettagli luogo recente perché name può scadere.
Imposta skipHttpRedirect su true in modo che la richiesta restituisca una risposta JSON. Per impostazione predefinita, la richiesta restituisce l'immagine, che non può essere visualizzata da Explorer API.
Seleziona il pulsante Esegui. Nel popup, scegli l'account che vuoi utilizzare per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona Espandi, , per espandere la finestra di Explorer API.