REST Resource: photo

সম্পদ: ছবি

ফটো মেটাডেটা সহ 360 ফটো সংরক্ষণ করতে ফটো ব্যবহার করা হয়।

JSON প্রতিনিধিত্ব
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
ক্ষেত্র
photoId

object ( PhotoId )

প্রয়োজন। শুধুমাত্র আউটপুট। একটি ফটো আপডেট করার সময় প্রয়োজন. শুধুমাত্র একটি ছবি তৈরি করার সময় আউটপুট। ছবির শনাক্তকারী, যা Google-এর সমস্ত ফটোর মধ্যে অনন্য।

uploadReference

object ( UploadRef )

শুধুমাত্র ইনপুট। একটি ছবি তৈরি করার সময় প্রয়োজন. শুধুমাত্র ইনপুট। রিসোর্স URL যেখানে ফটো বাইট আপলোড করা হয়।

downloadUrl

string

শুধুমাত্র আউটপুট। ফটো বাইটের জন্য ডাউনলোড URL। GetPhotoRequest.view যখন PhotoView.INCLUDE_DOWNLOAD_URL এ সেট করা থাকে তখনই এই ক্ষেত্রটি সেট করা হয়।

thumbnailUrl

string

শুধুমাত্র আউটপুট। প্রদত্ত ছবির পূর্বরূপ দেখানোর জন্য থাম্বনেইল URL।

pose

object ( Pose )

ঐচ্ছিক। ছবির পোজ।

connections[]

object ( Connection )

ঐচ্ছিক। অন্যান্য ছবির সাথে সংযোগ। একটি সংযোগ এই ফটো থেকে অন্য ফটোতে লিঙ্ক উপস্থাপন করে৷

captureTime

string ( Timestamp format)

ঐচ্ছিক। ছবি তোলার পর পরম সময়। যখন ফটোতে কোনো এক্সিফ টাইমস্ট্যাম্প থাকে না, তখন এটি ফটো মেটাডেটাতে একটি টাইমস্ট্যাম্প সেট করতে ব্যবহৃত হয়।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

uploadTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। ছবি আপলোড করার সময়।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

places[]

object ( Place )

ঐচ্ছিক। এই ফটোর অন্তর্গত স্থান.

viewCount

string ( int64 format)

শুধুমাত্র আউটপুট। ছবির ভিউ সংখ্যা।

transferStatus

enum ( TransferStatus )

শুধুমাত্র আউটপুট। এই ফটোতে অধিকার স্থানান্তরের স্থিতি।

mapsPublishStatus

enum ( MapsPublishStatus )

শুধুমাত্র আউটপুট। Google ম্যাপে স্থিতি, এই ফটোটি প্রকাশিত বা প্রত্যাখ্যান করা হয়েছে।

ফটো আইডি

একটি Photo জন্য শনাক্তকারী.

JSON প্রতিনিধিত্ব
{
  "id": string
}
ক্ষেত্র
id

string

একটি ছবির জন্য একটি অনন্য শনাক্তকারী.

আপলোড রেফ

মিডিয়া ফাইলের জন্য রেফারেন্স আপলোড করুন।

JSON প্রতিনিধিত্ব
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড file_source । প্রয়োজন। file_source নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
uploadUrl

string

একটি আপলোড রেফারেন্স প্রতিটি ব্যবহারকারীর জন্য অনন্য হওয়া উচিত। এটি ফর্মটি অনুসরণ করে: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

অঙ্গবিক্ষেপ

একটি সত্তার জন্য কাঁচা ভঙ্গি পরিমাপ।

JSON প্রতিনিধিত্ব
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
ক্ষেত্র
latLngPair

object ( LatLng )

ভঙ্গির অক্ষাংশ এবং দ্রাঘিমাংশের জুটি, যেমনটি এখানে ব্যাখ্যা করা হয়েছে: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng একটি Photo তৈরি করার সময়, যদি অক্ষাংশ এবং দ্রাঘিমাংশ জুড়ি দেওয়া না থাকে, exif হেডার থেকে ভূ-অবস্থান ব্যবহার করা হয়। ফটো বা এক্সিফ হেডারে একটি অক্ষাংশ এবং দ্রাঘিমাংশের জুড়ি দেওয়া না হলে ছবির প্রক্রিয়াটি ব্যর্থ হয়৷

altitude

number

WGS84 উপবৃত্তাকার উপরে মিটারে ভঙ্গির উচ্চতা। NaN একটি অপরিমিত পরিমাণ নির্দেশ করে।

heading

number

নিম্নলিখিত পোজ প্যারামিটারগুলি ছবির কেন্দ্রের সাথে সম্পর্কিত। তারা https://developers.google.com/streetview/spherical-metadata এর সাথে মেলে। কম্পাস শিরোনাম, ছবির কেন্দ্রে উত্তর থেকে ঘড়ির কাঁটার দিকে ডিগ্রী পরিমাপ করা হয়। মান হতে হবে >=0 এবং <360। NaN একটি অপরিমিত পরিমাণ নির্দেশ করে।

pitch

number

পিচ, ফটোর কেন্দ্রে ডিগ্রীতে পরিমাপ করা হয়। মান হতে হবে >=-90 এবং <= 90। -90-এর মান হল সরাসরি নিচের দিকে তাকানো এবং 90-এর মান হল সরাসরি উপরে দেখা। NaN একটি অপরিমিত পরিমাণ নির্দেশ করে।

roll

number

রোল, ডিগ্রী মাপা. মান হতে হবে >= 0 এবং <360। 0 এর মান মানে দিগন্তের সাথে স্তর। NaN একটি অপরিমিত পরিমাণ নির্দেশ করে।

gpsRecordTimestampUnixEpoch

string ( Timestamp format)

UTC যুগ থেকে GPS রেকর্ডের সময়।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

level

object ( Level )

লেভেল (একটি বিল্ডিংয়ের মেঝে) উল্লম্ব নেভিগেশন কনফিগার করতে ব্যবহৃত হয়।

accuracyMeters

number

68% আত্মবিশ্বাসের সাথে মিটারে এই ভঙ্গির আনুমানিক অনুভূমিক নির্ভুলতা (একটি আদর্শ বিচ্যুতি)। উদাহরণস্বরূপ, অ্যান্ড্রয়েডে, এই মানটি এই পদ্ধতি থেকে উপলব্ধ: https://developer.android.com/reference/android/location/Location#getAccuracy() । অন্যান্য প্ল্যাটফর্মের অনুরূপ নির্ভুলতা অনুমান প্রাপ্ত করার বিভিন্ন পদ্ধতি রয়েছে।

LatLng

একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রী অক্ষাংশ এবং ডিগ্রী দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য এক জোড়া দ্বিগুণ হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট করা না থাকলে, এই বস্তুটিকে অবশ্যই WGS84 মান মেনে চলতে হবে। মানগুলি অবশ্যই স্বাভাবিক সীমার মধ্যে থাকতে হবে৷

JSON প্রতিনিধিত্ব
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

ডিগ্রী অক্ষাংশ. এটি অবশ্যই [-90.0, +90.0] এর মধ্যে হতে হবে।

longitude

number

ডিগ্রী দ্রাঘিমাংশ. এটি অবশ্যই [-180.0, +180.0] পরিসরে হতে হবে।

স্তর

স্তর নম্বর এবং তার সংশ্লিষ্ট নাম ধারণকারী স্তর তথ্য.

JSON প্রতিনিধিত্ব
{
  "number": number,
  "name": string
}
ক্ষেত্র
number

number

ঐচ্ছিক। ফ্লোর নম্বর, অর্ডার করার জন্য ব্যবহৃত। 0 স্থল স্তর নির্দেশ করে, 1 স্থল স্তরের উপরে প্রথম স্তর নির্দেশ করে, -1 স্থল স্তরের নীচে প্রথম স্তর নির্দেশ করে। অ-পূর্ণসংখ্যা মান ঠিক আছে.

name

string

প্রয়োজন। এই স্তরে একটি নাম বরাদ্দ করা হয়েছে, 3টি অক্ষরের মধ্যে সীমাবদ্ধ৷ একটি লিফট থাকলে এই স্তরের জন্য লিফট বোতামগুলি কীভাবে লেবেল করা হবে তা বিবেচনা করুন।

সংযোগ

একটি সংযোগ হল একটি উত্স ফটো থেকে একটি গন্তব্য ছবির লিঙ্ক৷

JSON প্রতিনিধিত্ব
{
  "target": {
    object (PhotoId)
  }
}
ক্ষেত্র
target

object ( PhotoId )

প্রয়োজন। থাকা ফটো থেকে অন্য ফটোতে সংযোগের গন্তব্য।

স্থান

একটি সত্তার জন্য মেটাডেটা রাখুন।

JSON প্রতিনিধিত্ব
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
ক্ষেত্র
placeId

string

স্থান শনাক্তকারী, যেমনটি https://developers.google.com/places/place-id এ বর্ণনা করা হয়েছে।

name

string

শুধুমাত্র আউটপুট। স্থানের নাম, ভাষা কোডে স্থানীয়করণ করা হয়েছে।

languageCode

string

শুধুমাত্র আউটপুট। যে ভাষা কোডের সাথে নাম স্থানীয়করণ করা হয়েছে। এটি অনুরোধে নির্দিষ্ট করা ভাষাকোড হওয়া উচিত, তবে এটি একটি ফলব্যাক হতে পারে৷

ট্রান্সফার স্ট্যাটাস

অধিকার হস্তান্তরের স্থিতি।

Enums
TRANSFER_STATUS_UNKNOWN এই স্থানান্তরের অবস্থা অনির্দিষ্ট।
NEVER_TRANSFERRED এই ছবিটি কখনও স্থানান্তরিত হয়নি।
PENDING এই ফটো স্থানান্তর শুরু করা হয়েছে, কিন্তু রিসিভার এখনও সাড়া দেয়নি.
COMPLETED ফটো স্থানান্তর সম্পন্ন হয়েছে, এবং এই ছবিটি প্রাপকের কাছে স্থানান্তর করা হয়েছে৷
REJECTED প্রাপক এই ফটো স্থানান্তর প্রত্যাখ্যান করেছেন৷
EXPIRED প্রাপক কোনো ব্যবস্থা নেওয়ার আগেই ফটো ট্রান্সফারের মেয়াদ শেষ হয়ে গেছে।
CANCELLED প্রেরক এই ফটো স্থানান্তর বাতিল করেছেন৷
RECEIVED_VIA_TRANSFER অধিকার স্থানান্তরের কারণে প্রাপক এই ছবির মালিক৷

মানচিত্র প্রকাশের অবস্থা

গুগল ম্যাপে ছবির প্রকাশনার স্থিতি।

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS ছবির অবস্থা অজানা.
PUBLISHED ছবিটি গুগল ম্যাপের মাধ্যমে জনসাধারণের কাছে প্রকাশ করা হয়।
REJECTED_UNKNOWN ছবি একটি অজানা কারণে প্রত্যাখ্যান করা হয়েছে.

পদ্ধতি

create

 ক্লায়েন্ট প্রত্যাবর্তিত UploadRef এর সাথে ফটো আপলোড করা শেষ করার পরে, CreatePhoto আপলোড করা Photo Google মানচিত্রে রাস্তার দৃশ্যে প্রকাশ করে৷

delete

 একটি Photo এবং এর মেটাডেটা মুছে দেয়।

get

 নির্দিষ্ট Photo মেটাডেটা পায়।

startUpload

 ফটো বাইট আপলোড করা শুরু করতে একটি আপলোড সেশন তৈরি করে৷

update

 একটি Photo মেটাডেটা আপডেট করে, যেমন পোজ, স্থান সংযোজন, সংযোগ, ইত্যাদি।