REST Resource: photo

তথ্যসূত্র: ছবি

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

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 )

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

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)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

uploadTime

string ( Timestamp format)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

places[]

object ( Place )

ঐচ্ছিক। এই ছবিটি যে স্থানগুলিতে অবস্থিত।

viewCount

string ( int64 format)

শুধুমাত্র আউটপুট। ছবির ভিউ কাউন্ট।

transferStatus

enum ( TransferStatus )

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

mapsPublishStatus

enum ( MapsPublishStatus )

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

ছবির আইডি

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 হেডার থেকে ভূ-অবস্থান ব্যবহার করা হয়। ছবি বা exif হেডারে অক্ষাংশ এবং দ্রাঘিমাংশের জোড়া প্রদান করা না হলে ছবির প্রক্রিয়া ব্যর্থ হয়।

altitude

number

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

heading

number

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

pitch

number

ছবির কেন্দ্রে ডিগ্রীতে পরিমাপ করা পিচ। মান অবশ্যই >=-৯০ এবং <= ৯০ হতে হবে। -৯০ এর মান মানে সরাসরি নিচের দিকে তাকানো, এবং ৯০ এর মান মানে সরাসরি উপরের দিকে তাকানো। NaN একটি অ-পরিমাপিত পরিমাণ নির্দেশ করে।

roll

number

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

gpsRecordTimestampUnixEpoch

string ( Timestamp format)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

level

object ( Level )

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

accuracyMeters

number

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

অক্ষাংশ

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

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

ডিগ্রীতে অক্ষাংশ। এটি অবশ্যই [-৯০.০, +৯০.০] পরিসরে হতে হবে।

longitude

number

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

স্তর

স্তরের তথ্য যাতে স্তর নম্বর এবং তার সংশ্লিষ্ট নাম থাকে।

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

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

স্থানান্তর অবস্থা

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

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

ম্যাপপ্রকাশের স্থিতি

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

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

পদ্ধতি

create

 ক্লায়েন্ট রিটার্ন করা UploadRef দিয়ে ছবি আপলোড করা শেষ করার পর, CreatePhoto আপলোড করা Photo Google Maps-এর Street View-এ প্রকাশ করে।

delete

 একটি Photo এবং তার মেটাডেটা মুছে ফেলে।

get

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

startUpload

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

update

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