La foto del luogo (novità) un servizio è un'API di sola lettura che ti consente di aggiungere contenuti fotografici nella tua applicazione. Il servizio Place Photo offre accedi 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, potrai accedere alle foto a cui viene fatto riferimento e ridimensionarla in base alle dimensioni ottimali un'applicazione.
Explorer API ti consente di effettuare richieste in tempo reale per familiarizzare con l'API e Opzioni API:
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 parametromaxWidthPx
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 un
Luogo Dettagli (novità), Ricerca nelle vicinanze (nuova),
o Ricerca testuale (nuova)
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 in verrà ridimensionato per corrispondere alla dimensione più piccola tra le due, limitata alla sua dimensione originale proporzioni. 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 i dettagli dell'immagine.
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 un
nome della risorsa foto, restituito nella risposta a una ricerca nelle vicinanze, a una ricerca testuale o
Richiesta Place Details. La risposta a queste richieste contiene un array photos[]
se
luogo presenta contenuti fotografici correlati.
Ogni elemento di photo[]
contiene i seguenti campi:
name
: una stringa contenente il nome risorsa della foto quando per eseguire 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 è sempre presente, ma potrebbe essere vuoto.
Le foto restituite dal servizio Foto provengono da diverse località,
inclusi proprietari di attività e foto fornite dagli utenti. Nella maggior parte dei casi,
le foto possono essere utilizzate senza attribuzione o avranno l'attribuzione richiesta
inclusi nell'immagine. Tuttavia, se l'elemento photo
restituito
include un valore nel campo authorAttributions
, devi includere i campi
attribuzione aggiuntiva nella tua applicazione ovunque mostri l'immagine.
L'esempio seguente mostra una richiesta Place Details che include photos
in
la 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/ChIJ2fzCmcW7j4AR2JzfXBBoh6EDi 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 sia al massimo 400 pixel di altezza e larghezza:
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 di una richiesta 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 un HTTP 403 e visualizza l'immagine seguente per indicare che la quota è superato:
![Immagine per superamento quota](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/quota.png?authuser=4&hl=it)
Se il server non è in grado di comprendere la richiesta, viene restituito HTTP 400 che indica una richiesta non valida. I motivi più comuni per cui le richieste non valide includono:
- Il nome della foto inviata non è stato specificato correttamente.
- La richiesta non includeva
maxHeightPx
omaxWidthPx
. - È stato impostato il valore del parametro
maxHeightPx
omaxWidthtPx
anull
. - L'offerta
name
è scaduta. Sename
scade, effettua una richiedi a Dettagli luogo (Nuovo), Ricerca nelle vicinanze (Nuova), o Ricerca testuale (Novità) per ottenere un nuovoname
.
Prova
Explorer API ti consente di effettuare richieste di esempio di acquisire familiarità con le opzioni dell'API e delle 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
- Imposta
skipHttpRedirect
sutrue
in modo che la richiesta restituisca un JSON la risposta corretta. Per impostazione predefinita, la richiesta restituisce l'immagine, che non può essere visualizzata dal Explorer API. - Seleziona il pulsante Esegui. Nella finestra popup, scegli l'account da per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona Espandi,
, per espandere la finestra Explorer API.