- Ressource: Photo
- PhotoId
- UploadRef
- Pose
- LatLng
- Niveau
- Connexion
- Place
- TransferStatus (État de transfert)
- MapsPublishStatus
- Méthodes
Ressource: Photo
Photo permet de stocker des photos à 360° ainsi que leurs métadonnées.
Représentation JSON |
---|
{ "photoId": { object ( |
Champs | |
---|---|
photoId |
Obligatoire. Uniquement en sortie. Obligatoire lors de la modification d'une photo. Uniquement en sortie lors de la création d'une photo. Identifiant unique de toutes les photos sur Google. |
uploadReference |
Uniquement en entrée. Obligatoire lors de la création d'une photo. Uniquement en entrée. URL de la ressource vers laquelle les octets de la photo sont importés. |
downloadUrl |
Uniquement en sortie. URL de téléchargement des octets de la photo. Ce champ n'est défini que si |
thumbnailUrl |
Uniquement en sortie. URL de vignette pour afficher un aperçu de la photo donnée. |
shareLink |
Uniquement en sortie. Lien de partage de la photo. |
pose |
Facultatif. Photo de la photo. |
connections[] |
Facultatif. Connexions à d'autres photos Un lien représente le lien entre cette photo et une autre. |
captureTime |
Facultatif. Heure absolue à laquelle la photo a été prise Lorsqu'il n'y a pas d'horodatage exif pour la photo, ce paramètre permet de définir l'horodatage dans les métadonnées de la photo. Horodatage au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
uploadTime |
Uniquement en sortie. Heure à laquelle l'image a été importée. Horodatage au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
places[] |
Facultatif. Lieux auxquels cette photo est associée. |
viewCount |
Uniquement en sortie. Nombre de vues de la photo. |
transferStatus |
Uniquement en sortie. État des droits de transfert sur cette photo. |
mapsPublishStatus |
Uniquement en sortie. État dans Google Maps, que la photo ait été publiée ou refusée |
ID de la photo
Identifiant d'une Photo
.
Représentation JSON |
---|
{ "id": string } |
Champs | |
---|---|
id |
Identifiant unique d'une photo. |
Réf. importation
Référence d'importation des fichiers multimédias.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union file_source . Obligatoire. file_source ne peut être qu'un des éléments suivants : |
|
uploadUrl |
Une référence d'importation doit être unique pour chaque utilisateur. Elle se présente sous la forme suivante: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}" |
Posture
Mesure de posture brute pour une entité.
Représentation JSON |
---|
{ "latLngPair": { object ( |
Champs | |
---|---|
latLngPair |
Paire de latitude et longitude de la position, comme expliqué ici: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Lorsque vous créez une |
altitude |
Altitude de la position en mètres au-dessus de l'ellipsoïde WGS84. NaN indique une quantité non mesurée. |
heading |
Les paramètres de position suivants concernent le centre de la photo. Elles correspondent à https://developers.google.com/streetview/spherical-metadata. Direction de la boussole, mesurée au centre de la photo en degrés dans le sens des aiguilles d'une montre à partir du nord. La valeur doit être >=0 et <360. NaN indique une quantité non mesurée. |
pitch |
Inclinaison, mesurée au centre de la photo en degrés. La valeur doit être >= 90 et <= 90. Une valeur de -90 indique une vue directe vers le bas et une valeur de 90 correspond à une recherche directe vers le haut. NaN indique une quantité non mesurée. |
roll |
Roulement, mesuré en degrés. La valeur doit être >= 0 et < 360. La valeur 0 correspond au niveau avec l'horizon. NaN indique une quantité non mesurée. |
gpsRecordTimestampUnixEpoch |
Heure de l'enregistrement GPS depuis l'epoch UTC. Horodatage au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
level |
Niveau (étage d'un bâtiment) utilisé pour configurer la navigation verticale. |
accuracyMeters |
Précision horizontale estimée de cette position en mètres avec un indice de confiance de 68 % (un écart type). Par exemple, sur Android, cette valeur est disponible via la méthode https://developer.android.com/reference/android/location/Location#getAccuracy(). D'autres plates-formes ont des méthodes différentes pour obtenir des estimations de précision similaires. |
LatLng
Objet représentant une paire latitude/longitude. Cette valeur est exprimée par une paire de doubles représentant les degrés de latitude et de longitude. Sauf indication contraire, cet objet doit être conforme à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.
Représentation JSON |
---|
{ "latitude": number, "longitude": number } |
Champs | |
---|---|
latitude |
Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0]. |
longitude |
Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0]. |
Niveau
Informations sur le niveau contenant le numéro du niveau et son nom correspondant.
Représentation JSON |
---|
{ "number": number, "name": string } |
Champs | |
---|---|
number |
Facultatif. Numéro d'étage, utilisé pour la commande. 0 indique le rez-de-chaussée, 1 indique le premier niveau au-dessus du rez-de-chaussée, -1 indique le premier niveau sous le niveau du sol. Les valeurs non entières sont acceptables. |
name |
Obligatoire. Nom attribué à ce niveau, limité à 3 caractères. Pensez à la façon dont les boutons d'ascenseur seraient libellés pour ce niveau s'il y avait un ascenseur. |
Connexion
Une connexion correspond au lien entre une photo source et une photo de destination.
Représentation JSON |
---|
{
"target": {
object ( |
Champs | |
---|---|
target |
Obligatoire. Destination de la connexion entre la photo parent et une autre. |
Lieu
Placez des métadonnées pour une entité.
Représentation JSON |
---|
{ "placeId": string, "name": string, "languageCode": string } |
Champs | |
---|---|
placeId |
Identifiant de lieu, comme décrit dans https://developers.google.com/places/place-id. |
name |
Uniquement en sortie. Nom du lieu, localisé dans le code de langue. |
languageCode |
Uniquement en sortie. Code de langue avec lequel le nom est localisé. Il s'agit du langage de code spécifié dans la requête. Toutefois, il peut s'agir d'un remplacement. |
État du transfert
État du transfert des droits.
Enums | |
---|---|
TRANSFER_STATUS_UNKNOWN |
L'état de ce transfert n'est pas spécifié. |
NEVER_TRANSFERRED |
Cette photo n'a jamais été transférée. |
PENDING |
Le transfert de photos a été lancé, mais le destinataire n'a pas encore répondu. |
COMPLETED |
Le transfert de la photo a été effectué et la photo a été transférée au destinataire. |
REJECTED |
Le destinataire a refusé ce transfert de photos. |
EXPIRED |
Le transfert de photos a expiré avant que le destinataire ait effectué une action. |
CANCELLED |
L'expéditeur a annulé le transfert de la photo. |
RECEIVED_VIA_TRANSFER |
Le destinataire est le propriétaire de cette photo en raison d'un transfert de droits. |
MapsPublishStatus
État de publication de la photo dans Google Maps.
Enums | |
---|---|
UNSPECIFIED_MAPS_PUBLISH_STATUS |
L'état de la photo est inconnu. |
PUBLISHED |
La photo est publiée publiquement via Google Maps. |
REJECTED_UNKNOWN |
La photo a été refusée pour une raison inconnue. |
Méthodes |
|
---|---|
|
Une fois que le client a fini d'importer la photo avec les UploadRef renvoyées, CreatePhoto publie les Photo importées dans Street View sur Google Maps. |
|
Supprime un Photo et ses métadonnées. |
|
Récupère les métadonnées de l'élément Photo spécifié. |
|
Crée une session d'importation pour commencer à importer des octets de photos. |
|
Met à jour les métadonnées d'une Photo , telles que la position, l'association de lieux, les connexions, etc. |