ভূমিকা
আপনার কাছে প্লেস আইডি থাকলে, আপনি কোনও নির্দিষ্ট প্রতিষ্ঠান বা আকর্ষণীয় স্থান সম্পর্কে আরও বিবরণ জানতে জায়গার বিবরণ (নতুন) অনুরোধ করতে পারেন। Place Details (New) অনুরোধের মাধ্যমে নির্দিষ্ট করা জায়গা সম্পর্কে আরও বিস্তারিত তথ্য পাওয়া যায় যেমন, সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং ও রিভিউ।
প্লেস আইডি পাওয়ার অনেক উপায় আছে। আপনি এগুলি ব্যবহার করতে পারেন:
- টেক্সট সার্চ (নতুন) অথবা নিয়ারবাই Search (নতুন)
- Geocoding API
- Routes API
- Address Validation API
- অটোমেটিক সম্পূর্ণ করা (নতুন)
APIs Explorer আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পের সাথে পরিচিত হতে পারেন:
জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধ
Place Details (New) অনুরোধ হল এই ফর্ম্যাটে একটি HTTP GET অনুরোধ:
https://places.googleapis.com/v1/places/PLACE_ID
URL প্যারামিটার হিসেবে বা GET অনুরোধের অংশ হিসেবে হেডারে সব প্যারামিটার পাস করুন। যেমন:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEYঅথবা curl কমান্ডে:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Place Details (New) রেসপন্স
জায়গার বিবরণ (নতুন) রেসপন্স হিসেবে JSON অবজেক্ট রিটার্ন করে। উত্তরে:
- রেসপন্সটি একটি
Placeঅবজেক্ট দ্বারা উপস্থাপিত হয়।Placeঅবজেক্টে জায়গা সম্পর্কে বিস্তারিত তথ্য থাকে। - অনুরোধে পাস করা FieldMask,
Placeঅবজেক্টে ফেরত আসা ফিল্ডের তালিকা নির্দিষ্ট করে।
সম্পূর্ণ JSON অবজেক্টটি এই ফর্ম্যাটে আছে:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
প্রয়োজনীয় প্যারামিটার
-
FieldMask
রেসপন্স ফিল্ড মাস্ক তৈরি করে রেসপন্সে ফিরিয়ে দেওয়ার জন্য ফিল্ডের তালিকা নির্দিষ্ট করুন। URL প্যারামিটার
$fieldsবাfieldsঅথবা HTTP হেডারX-Goog-FieldMaskব্যবহার করে পদ্ধতিতে রেসপন্স ফিল্ড মাস্ক পাস করুন। উত্তরে ফেরত আসা ফিল্ডের কোনও ডিফল্ট তালিকা নেই। আপনি ফিল্ড মাস্ক বাদ দিলে, পদ্ধতিটি একটি ত্রুটি দেখায়।ফিল্ড মাস্কিং হল একটি ভালো ডিজাইন প্র্যাক্টিস যা নিশ্চিত করে যে আপনি অপ্রয়োজনীয় ডেটার জন্য অনুরোধ করছেন না, যা অপ্রয়োজনীয় প্রসেসিং সময় এবং বিলিং চার্জ এড়াতে সাহায্য করে।
ফেরত পাঠানোর জন্য কমা দিয়ে আলাদা করা জায়গার ডেটার ধরনের তালিকা উল্লেখ করুন। যেমন, জায়গার নাম ও ঠিকানা খুঁজে পেতে।
X-Goog-FieldMask: displayName,formattedAddress
সব ফিল্ড ফিরিয়ে আনতে
*ব্যবহার করুন।X-Goog-FieldMask: *
নিচে উল্লেখ করা ফিল্ডের মধ্যে এক বা একাধিক ফিল্ড নির্দিষ্ট করুন:
নিম্নলিখিত ফিল্ডগুলি Place Details Essentials IDs Only SKU ট্রিগার করে:
attributions
consumerAlert
id
movedPlace
movedPlaceId
name*
photos
*
nameফিল্ডে জায়গার রিসোর্সের নাম এই ফর্ম্যাটে থাকে:places/PLACE_ID। জায়গার টেক্সট নাম পেতে, Pro SKU-তেdisplayNameফিল্ডের জন্য অনুরোধ করুন।ফিল্ডের সম্পূর্ণ তালিকা এবং তাদের সাথে সম্পর্কিত SKU-এর জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ডগুলি জায়গার বিবরণ সংক্রান্ত প্রয়োজনীয় SKU ট্রিগার করে:
addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
* ঠিকানা বর্ণনাকারী সাধারণত ভারতের গ্রাহকদের জন্য উপলভ্য এবং অন্য কোথাও পরীক্ষামূলকভাবে ব্যবহার করা হয়।
ফিল্ডের সম্পূর্ণ তালিকা এবং তাদের সাথে সম্পর্কিত SKU-এর জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ডগুলি Place Details Pro SKU ট্রিগার করে:
accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsTypeLabel
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
openingDate
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
timeZone
utcOffsetMinutes
ফিল্ডের সম্পূর্ণ তালিকা এবং তাদের সাথে সম্পর্কিত SKU-এর জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ডগুলি জায়গার বিবরণ Enterprise SKU ট্রিগার করে:
currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
transitStation
userRatingCount
websiteUriফিল্ডের সম্পূর্ণ তালিকা এবং তাদের সাথে সম্পর্কিত SKU-এর জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ডগুলি জায়গার বিবরণ Enterprise + Atmosphere SKU ট্রিগার করে:
allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
* শুধুমাত্র টেক্সট সার্চ ও নিয়ারবাই সার্চফিল্ডের সম্পূর্ণ তালিকা এবং তাদের সাথে সম্পর্কিত SKU-এর জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।
-
placeId
একটি টেক্সট শনাক্তকারী যা অনন্যভাবে একটি স্থান শনাক্ত করে, যা টেক্সট সার্চ (নতুন) বা আশেপাশে সার্চ (নতুন) থেকে পাওয়া যায়। প্লেস আইডি সম্পর্কে আরও তথ্যের জন্য, প্লেস আইডি ওভারভিউ দেখুন।
places/PLACE_IDস্ট্রিংটিকে জায়গার রিসোর্সের নামও বলা হয়। জায়গার বিবরণ (নতুন), নিয়ারবাই Search (নতুন) এবং টেক্সট সার্চ (নতুন) অনুরোধের উত্তরে, এই স্ট্রিং উত্তরেরnameফিল্ডে থাকে। স্ট্যান্ডঅ্যালোন জায়গার আইডি উত্তরেরidফিল্ডে থাকে।
ঐচ্ছিক প্যারামিটার
languageCode
যে ভাষায় ফলাফল দেখানো হবে।
- অনুমোদিত ভাষার তালিকা দেখুন। Google প্রায়ই কাজ করে এমন ভাষার তালিকা আপডেট করে, তাই এই তালিকা সম্পূর্ণ নাও হতে পারে।
-
languageCodeপ্রদান করা না হলে, API ডিফল্ট হিসেবেenব্যবহার করে। আপনি ভুল ভাষার কোড উল্লেখ করলে, API একটিINVALID_ARGUMENTসমস্যা দেখায়। - API এমন রাস্তার ঠিকানা প্রদান করার যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী ও স্থানীয় লোকজন উভয়ের জন্যই বোধগম্য হয়। এই লক্ষ্য পূরণ করতে, এটি স্থানীয় ভাষায় রাস্তার ঠিকানা ফেরত পাঠায়, যা ব্যবহারকারীর পছন্দের ভাষা অনুযায়ী, প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য স্ক্রিপ্টে লিপ্যন্তর করা হয়। অন্যান্য সব ঠিকানা পছন্দের ভাষায় দেখানো হয়। ঠিকানার সব কম্পোনেন্ট একই ভাষায় দেখানো হয়, যা প্রথম কম্পোনেন্ট থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনও নাম উপলভ্য না থাকলে, API সবচেয়ে কাছাকাছি ম্যাচ ব্যবহার করে।
- API যে ফলাফল দেখায় এবং যে ক্রমে দেখায়, তার উপর পছন্দের ভাষার সামান্য প্রভাব থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ, বা সমার্থক শব্দ যা একটি ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়।
regionCode
উত্তরের ফর্ম্যাট করার জন্য ব্যবহৃত অঞ্চল কোড, যা দুটি অক্ষর বিশিষ্ট CLDR কোড মান হিসেবে নির্দিষ্ট করা হয়েছে। কোনও ডিফল্ট ভ্যালু নেই।
উত্তরে
formattedAddressফিল্ডের দেশের নামregionCode-এর সাথে মিলে গেলে,formattedAddressথেকে দেশের কোড বাদ দেওয়া হয়। এই প্যারামিটারadrFormatAddress-এর উপর কোনও প্রভাব ফেলে না, যা সবসময় দেশের নাম অন্তর্ভুক্ত করে, অথবাshortFormattedAddress-এর উপর, যা কখনই এটি অন্তর্ভুক্ত করে না।বেশিরভাগ CLDR কোড ISO 3166-1 কোডের মতোই, তবে কিছু উল্লেখযোগ্য ব্যতিক্রম আছে। যেমন, যুক্তরাজ্যের ccTLD হল "uk" (.co.uk) এবং এর ISO 3166-1 কোড হল "gb" (টেকনিক্যালি "The United Kingdom of Great Britain and Northern Ireland" এন্টিটির জন্য)। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটার ফলাফলে প্রভাব ফেলতে পারে।
-
sessionToken
সেশন টোকেন হল ব্যবহারকারীর তৈরি করা স্ট্রিং যা অটোমেটিক সম্পূর্ণ (নতুন) কলকে "সেশন" হিসেবে ট্র্যাক করে। অটোকমপ্লিট (নতুন) সেশন টোকেন ব্যবহার করে কোয়েরি গ্রুপ করে এবং বিলিংয়ের উদ্দেশ্যে ব্যবহারকারীর অটোকমপ্লিট সার্চের জায়গা বেছে নেওয়ার ধাপগুলিকে একটি পৃথক সেশনে রাখে। সেশন টোকেনগুলি জায়গার বিবরণ (নতুন) কলে পাস করা হয় যা অটোমেটিক সম্পূর্ণ (নতুন) কল অনুসরণ করে। আরও তথ্যের জন্য, সেশন টোকেন দেখুন।
জায়গার বিবরণ (নতুন) সংক্রান্ত উদাহরণ
নিচের উদাহরণে placeId-এর মাধ্যমে কোনও জায়গার বিবরণ
অনুরোধ করা হয়েছে:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
মনে রাখবেন যে X-Goog-FieldMask হেডার নির্দিষ্ট করে যে
উত্তরে
নিম্নলিখিত ডেটা ফিল্ড আছে: id,displayName।
তারপর উত্তরটি এই ফর্ম্যাটে পাওয়া যায়:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
অতিরিক্ত তথ্য ফেরত পেতে ফিল্ড মাস্কে আরও ডেটার ধরন যোগ করুন।
যেমন, উত্তরে ঠিকানা ও Plus Code
যোগ করতে formattedAddress,plusCode
লিখুন:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
উত্তরটি এখন এই ফর্মে আছে:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
রেটিং, রিভিউয়ের সংখ্যা ও রিভিউ পান
কোনও ব্যবসার গড় স্টার রেটিং, মোট রেটিংয়ের সংখ্যা (মোট রিভিউ) বা গ্রাহকের রিভিউ টেক্সট
পেতে, আপনার X-Goog-FieldMask হেডারে সংশ্লিষ্ট ফিল্ডগুলি
অন্তর্ভুক্ত করুন:
ratingএবংuserRatingCount: জায়গার গড় রেটিং (1.0থেকে5.0পর্যন্ত) এবং মোট রিভিউয়ের সংখ্যা দেখায়। এইসব ফিল্ডের জন্য অনুরোধ করা হলে, জায়গার বিবরণ Enterprise SKU ট্রিগার হয়।reviewsএবংreviewSummary: ব্যবহারকারীর জমা দেওয়া সর্বাধিক পাঁচটিReviewঅবজেক্ট এবং রিভিউয়ের AI-জেনারেটেড সারসংক্ষেপ দেখায়। এইসব ফিল্ডের জন্য অনুরোধ করলে জায়গার বিবরণ Enterprise + Atmosphere SKU ট্রিগার হয়।
আপনার অ্যাপের যদি শুধু স্টার রেটিং এবং মোট রিভিউ সংখ্যা প্রয়োজন হয়, তাহলে
reviews
ছাড়া
rating
এবং
userRatingCount
অনুরোধ করুন
যাতে অনুরোধটি
Place Details Enterprise SKU
টিয়ারে থাকে:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
এছাড়াও, ব্যবহারকারীর জমা দেওয়া সর্বাধিক পাঁচটি
Review
অবজেক্ট ফিরিয়ে আনতে, ফিল্ড মাস্কে
reviews
যোগ করুন (
জায়গার বিবরণ Enterprise + Atmosphere SKU
টিয়ারে বিল করা হয়):
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
উত্তরে রেটিং, মোট রেটিংয়ের সংখ্যা এবং
reviews
অ্যারে অন্তর্ভুক্ত থাকে:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" }, "rating": 4.2, "userRatingCount": 2594, "reviews": [ { "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...", "relativePublishTimeDescription": "a month ago", "rating": 5, "text": { "text": "Iconic tech campus with visitor areas and cafes.", "languageCode": "en" }, "authorAttribution": { "displayName": "Alex Rivera" } } ] }
ঠিকানার বিবরণ পান
ঠিকানার বিবরণ কোনও জায়গার লোকেশন সম্পর্কে সম্পর্কিত তথ্য প্রদান করে, যার মধ্যে আশেপাশের ল্যান্ডমার্ক এবং এলাকা অন্তর্ভুক্ত।
নিচের উদাহরণে সান জোসের একটি মলে ডিপার্টমেন্টাল স্টোরের জন্য
জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধ দেখানো হয়েছে। এই উদাহরণে, আপনি ফিল্ড মাস্কে addressDescriptors
অন্তর্ভুক্ত করেছেন:
curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: name,displayName,addressDescriptor"
উত্তরে অনুরোধে উল্লেখ করা জায়গা, আশেপাশের ল্যান্ডমার্কের তালিকা ও জায়গা থেকে সেগুলির দূরত্ব এবং এলাকার তালিকা ও জায়গার সাথে সেগুলির কন্টেনমেন্ট সম্পর্ক অন্তর্ভুক্ত থাকে:
{ "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "displayName": { "text": "Macy's", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "food", "movie_theater", "point_of_interest", "restaurant", "shoe_store", "shopping_mall", "store" ], "spatialRelationship": "WITHIN", "straightLineDistanceMeters": 220.29175 }, { "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4", "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4", "displayName": { "text": "Nordstrom", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 329.45178 }, { "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "displayName": { "text": "Monroe Parking Garage", "languageCode": "en" }, "types": [ "establishment", "parking", "point_of_interest" ], "straightLineDistanceMeters": 227.05153 }, { "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM", "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM", "displayName": { "text": "Studios Inn by Daiwa Living California Inc.", "languageCode": "en" }, "types": [ "establishment", "lodging", "point_of_interest", "real_estate_agency" ], "straightLineDistanceMeters": 299.9955 }, { "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "displayName": { "text": "Din Tai Fung", "languageCode": "en" }, "types": [ "establishment", "food", "point_of_interest", "restaurant" ], "straightLineDistanceMeters": 157.70943 } ], "areas": [ { "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "displayName": { "text": "Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM", "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM", "displayName": { "text": "Central San Jose", "languageCode": "en" }, "containment": "WITHIN" } ] } }
স্থানান্তরিত জায়গার বিবরণ পান
আপনার অ্যাপে উল্লেখ করা কোনও জায়গা যদি স্থানান্তরিত হয়ে থাকে, তাহলে আপনি
movedPlace এবং movedPlaceId ফিল্ড ব্যবহার করে নতুন জায়গাটির বিবরণ পেতে পারেন।
যেসব জায়গা স্থায়ীভাবে বন্ধ, সেগুলির ক্ষেত্রে Place Details (New) রেসপন্স বডিতে businessStatus ফিল্ডে CLOSED_PERMANENTLY রিটার্ন করে এবং movedPlace ও movedPlaceId ফিল্ড বাদ দেয়।
যেসব জায়গা নতুন লোকেশনে সরিয়ে নিয়ে যাওয়া হয়েছে, সেগুলির ক্ষেত্রে Place Details (New) API রেসপন্স বডির
businessStatus ফিল্ডে CLOSED_PERMANENTLY এবং movedPlace ও
movedPlaceId ফিল্ডে নতুন লোকেশন দেখায়।
যেসব জায়গা সরানো হয়নি, সেগুলির ক্ষেত্রে Place Details (New) রেসপন্স বডিতে
movedPlace বা movedPlaceId দেখায় না।
নিম্নলিখিত উদাহরণে কানাডার কুইবেকে Marche IGA St-Canut-এর জায়গা সংক্রান্ত তথ্য চাওয়া হয়েছে:
curl -X GET -H 'Content-Type: application/json' \ -H 'x-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \ https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ
অনুরোধটি নিম্নলিখিত উত্তর প্রদান করে:
{ "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ", "businessStatus": "CLOSED_PERMANENTLY", "displayName": { "text": "Marche IGA St-Canut", "languageCode": "en" }, "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ", "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ" }
নতুন জায়গা সম্পর্কে বিবরণ পেতে, নতুন জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধের movedPlace ফিল্ডে
জায়গার রিসোর্স নাম ব্যবহার করুন।
যেসব জায়গা একাধিকবার স্থানান্তরিত হয়েছে, সেগুলির বর্তমান লোকেশন সম্পর্কে তথ্য পেতে
একাধিক চেইন করা জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধের প্রয়োজন হতে পারে। কোনও জায়গার ফলাফলের movedPlace এবং
movedPlaceId ফিল্ড শুধুমাত্র পরবর্তী লোকেশন দেখায়, শেষ
জানা লোকেশন নয়। কোনও জায়গা তার বর্তমান লোকেশনে আছে বলে ধরা হয় যদি কোনও জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধের
উত্তরে movedPlace এবং movedPlaceId ফিল্ড না থাকে।
ভবিষ্যতে খুলবে এমন ব্যবসা খুঁজুন
ভবিষ্যতে খুলতে পারে এমন ব্যবসার বিবরণ আপনি অনুরোধ করতে পারেন।
প্রত্যাশিত খোলার তারিখে অন্তত মাস উল্লেখ থাকলে এবং তা ৯০ দিনের কম দূরে হলে,
নিয়ারবাই Search (নতুন) openingDate ফিল্ড পূরণ করবে।
নিচের উদাহরণে, Idaho-র New Meadows-এ ভবিষ্যতে খুলবে এমন ব্যবসার জন্য নিয়ারবাই Search (নতুন) অনুরোধ দেখানো হয়েছে:
curl -X GET \ -H "Content-Type: application/json" \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,businessStatus,openingDate" \ "https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"
উত্তরে জায়গার ব্যবসার স্ট্যাটাস এবং খোলার সম্ভাব্য তারিখ অন্তর্ভুক্ত থাকে:
{ "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "openingDate": { "year": 2026, "month": 4, "day": 15 } }
ট্রানজিট স্টেশন সংক্রান্ত তথ্য পান
ট্রানজিট স্টেশন সম্পর্কে তথ্য পেতে আপনি জায়গার বিবরণ (নতুন) ব্যবহার করতে পারেন। রেসপন্স বডিতে স্টেশন সম্পর্কিত তথ্য অন্তর্ভুক্ত থাকে, যার মধ্যে স্টেশনের নাম, অ্যাফিলিয়েট করা ট্রানজিট এজেন্সি এবং স্টেশনে পরিষেবা প্রদানকারী ট্রানজিট লাইন অন্তর্ভুক্ত। এছাড়াও, উত্তরে একটি গাড়ির আইকন এবং রঙ অন্তর্ভুক্ত থাকে যা আপনি ট্রানজিট স্টেশনের তথ্য দেখাতে ব্যবহার করতে পারেন।
নিম্নলিখিত উদাহরণে গ্র্যান্ড সেন্ট্রাল স্টেশনের জন্য ট্রানজিট স্টেশন সংক্রান্ত তথ্যের অনুরোধ দেখানো হয়েছে:
curl -X GET \ -H "Content-Type: application/json" \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,transitStation" \ "https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"
রেসপন্স বডিতে ব্যাসার্ধের মধ্যে প্রতিটি স্টেশন, স্টেশন দ্বারা পরিবেশিত লাইন, সেই স্টপে ট্রানজিট এজেন্সি দ্বারা জারি করা সতর্কতা, এবং ছাড়ার তথ্য অন্তর্ভুক্ত থাকে:
{ "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg", "displayName": { "text": "Grand Central", "languageCode": "en" }, "transitStation": { "displayName": { "text": "Grand Central", "languageCode": "en" }, "agencies": [ { "displayName": { "text": "MTA New York City Transit", "languageCode": "en" }, "url": "http://www.mta.info/", "lines": [ { "id": "ChIJ420yFwBZwokR903kVZLSsFc", "vehicleType": "SUBWAY", "displayName": { "text": "42 St Shuttle", "languageCode": "en" }, "shortDisplayName": { "text": "S", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#808183", "url": "https://www.mta.info/schedules/subway/42-st-shuttle", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } }, { "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM", "vehicleType": "SUBWAY", "displayName": { "text": "5 Train (Lexington Av Express)", "languageCode": "en" }, "shortDisplayName": { "text": "5 Line", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#00933C", "url": "https://www.mta.info/schedules/subway/5-train", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } } ... ] }, { "displayName": { "text": "MTA", "languageCode": "en" }, "url": "https://new.mta.info/", "lines": [ { "id": "ChIJcwVpzKpZwokR24EBeh8arww", "vehicleType": "BUS", "displayName": { "text": "United Nations - W 42 St Pier", "languageCode": "en" }, "shortDisplayName": { "text": "M42", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#1D59B3", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg" } } ] }, { "displayName": { "text": "Long Island Rail Road", "languageCode": "en" }, "url": "http://www.mta.info/lirr", "lines": [ { "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0", "vehicleType": "HEAVY_RAIL", "displayName": { "text": "Ronkonkoma Branch", "languageCode": "en" }, "shortDisplayName": { "text": "LIRR", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#A626AA", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg" } } ... ] } ], "stops": [ { "id": "ChIJRcemlf1YwokRhFqqw5jKBFM", "stopCode": { "text": "GCT" }, "location": { "latitude": 40.755161, "longitude": -73.975456 }, "wheelchairAccessibleEntrance": true }, { "id": "ChIJ57l2zANZwokRD1pyhuwpfKY", "signageText": { "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7", "languageCode": "en" }, "location": { "latitude": 40.750983, "longitude": -73.9750686 }, "wheelchairAccessibleEntrance": true }, { "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc", "displayName": { "text": "E 42 St/Park Av", "languageCode": "en" }, "location": { "latitude": 40.7518199, "longitude": -73.9771918 }, "wheelchairAccessibleEntrance": true } ... ] } }
প্রবেশপথ ও নেভিগেশন পয়েন্ট পান
আপনি কোনও গন্তব্যের প্রবেশপথ ও নেভিগেশন পয়েন্টের জন্য অনুরোধ করতে পারেন। প্রবেশপথ কোনও জায়গার প্রবেশ ও প্রস্থানের পয়েন্ট নির্ধারণ করে (যেমন, কোনও এয়ারপোর্ট বা মলের বিভিন্ন গেট)। নেভিগেশন পয়েন্ট রাস্তার পাশে এমন লোকেশনকে সংজ্ঞায়িত করে যেখানে নেভিগেশন শেষ হওয়া উচিত, যা ব্যবহারকারীদের রাস্তার সঠিক দিকে বা নির্দিষ্ট ড্রপ-অফ পয়েন্টে নির্দেশ করার জন্য উপযোগী।
নেভিগেশন পয়েন্ট navigationPointToken রিটার্ন করে। ড্রাইভারদের নির্দিষ্ট লোকেশনে নিয়ে যাওয়ার জন্য আপনি এই টোকেন Navigation SDK (Android বা iOS-এর জন্য উপলভ্য) বা Routes API-তে পাস করতে পারবেন। আরও তথ্যের জন্য, নেভিগেশন পয়েন্ট টোকেন দেখুন।
নিম্নলিখিত উদাহরণে সান ফ্রান্সিসকো আন্তর্জাতিক বিমানবন্দরের (প্লেস আইডি ChIJVVVVVYx3j4ARP-3NGldc8qQ) বিবরণ চাওয়া হয়েছে, যার মধ্যে ফিল্ড মাস্কে entrances এবং navigationPoints অন্তর্ভুক্ত রয়েছে:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \ https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ
উত্তরে জায়গার প্রবেশপথ ও নেভিগেশন পয়েন্ট অন্তর্ভুক্ত আছে:
{ "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ", "displayName": { "text": "San Francisco International Airport", "languageCode": "en" }, "entrances": [ { "location": { "latitude": 37.6172154, "longitude": -122.3839724 } }, { "location": { "latitude": 37.6174073, "longitude": -122.384196 } }, ... ], "navigationPoints": [ { "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...", "displayName": { "text": "International Terminal Departures Level", "languageCode": "en" }, "location": { "latitude": 37.6153121, "longitude": -122.3900833 }, "travelModes": ["WALK"] }, { "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...", "displayName": { "text": "Domestic Garage - SFO Short Term Parking", "languageCode": "en" }, "location": { "latitude": 37.6157153, "longitude": -122.3885012 }, "travelModes": ["DRIVE", "WALK"], "usages": ["PARKING"] }, ... ] }
এটি ব্যবহার করে দেখুন!
APIs Explorer আপনাকে স্যাম্পেল অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পের সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে API আইকন api বেছে নিন।
ঐচ্ছিকভাবে, অনুরোধের প্যারামিটার এডিট করুন।
এক্সিকিউট করুন বোতামটি বেছে নিন। ডায়ালগে, অনুরোধ করার জন্য আপনি যে অ্যাকাউন্ট ব্যবহার করতে চান সেটি বেছে নিন।
APIs Explorer প্যানেলে, APIs Explorer উইন্ডো বড় করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন বেছে নিন।