ভূমিকা
প্লেস আইডি পেয়ে গেলে, আপনি প্লেস বিবরণ (নতুন) অনুরোধ করে কোনও নির্দিষ্ট এস্ট্যাবলিশমেন্ট বা আগ্রহের স্থান সম্পর্কে আরও বিবরণ জানতে চাইতে পারেন। 'জায়গার বিবরণ (নতুন) ' অনুরোধের মাধ্যমে উল্লিখিত জায়গা সম্পর্কে আরও বিস্তারিত তথ্য পাওয়া যায় যেমন, সেটির সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং ও রিভিউ।
প্লেস আইডি পাওয়ার অনেক উপায় আছে। আপনি এগুলি ব্যবহার করতে পারেন:
- টেক্সট সার্চ (নতুন) অথবা নিয়ারবাই সার্চ (নতুন)
- Geocoding API
- Routes API
- Address Validation API
- অটোকমপ্লিট (নতুন)
API এক্সপ্লোরার আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API ও API বিকল্প সম্পর্কে পরিচিত হতে পারেন:
জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধ
জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধ হল 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: *
নিম্নলিখিত ফিল্ডের মধ্যে একটি বা একাধিক ফিল্ড নির্দিষ্ট করুন:
নিম্নলিখিত ফিল্ড শুধুমাত্র স্থান সম্পর্কিত বিবরণ এসেনশিয়াল আইডি SKU ট্রিগার করে:
attributions
consumerAlert
id
movedPlace
movedPlaceId
name*
photos
*
nameফিল্ডে জায়গার রিসোর্সের নাম এই ফর্ম্যাটে থাকে:places/PLACE_ID। জায়গার টেক্সট নাম পেতে, Pro SKU-তেdisplayNameফিল্ডের জন্য অনুরোধ করুন।ফিল্ড ও সংশ্লিষ্ট SKU-এর সম্পূর্ণ তালিকা দেখতে, প্লেস ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ড Place Details Essentials 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-এর সম্পূর্ণ তালিকা দেখতে, প্লেস ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ড জায়গার বিবরণ এন্টারপ্রাইজ SKU ট্রিগার করে:
currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
transitStation
userRatingCount
websiteUriফিল্ডের সম্পূর্ণ তালিকা এবং তাদের সাথে সম্পর্কিত SKU-এর জন্য, জায়গার ডেটা ফিল্ড (নতুন) দেখুন।
নিম্নলিখিত ফিল্ড Place Details 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স্ট্রিংটিকে জায়গার রিসোর্স নামও বলা হয়। জায়গার বিবরণ (নতুন), আশেপাশের সার্চ (নতুন) ও টেক্সট সার্চ (নতুন) অনুরোধের উত্তরে, এই স্ট্রিংটি উত্তরের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" (টেকনিক্যালি "গ্রেট ব্রিটেন ও উত্তর আয়ারল্যান্ডের যুক্তরাজ্য" এন্টিটির জন্য)। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটার ফলাফলে প্রভাব ফেলতে পারে।
-
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" } }
ঠিকানার বিবরণ পান
ঠিকানার বিবরণ কোনও জায়গার লোকেশন সম্পর্কে পারস্পরিক তথ্য প্রদান করে, এর মধ্যে আশেপাশের ল্যান্ডমার্ক ও অন্তর্ভুক্ত এলাকা পড়ে।
নিচের উদাহরণে সান জোসে মলের
একটি ডিপার্টমেন্ট স্টোরের জন্য 'স্থান সম্পর্কিত বিবরণ (নতুন)' অনুরোধ দেখানো হয়েছে। এই উদাহরণে, ফিল্ড মাস্কে 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 ফিল্ডে নতুন লোকেশন রিটার্ন করে।
যেসব জায়গা সরানো হয়নি, সেগুলির জন্য, 'জায়গার বিবরণ (নতুন)' রেসপন্স বডিতে
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 ফিল্ড থাকে না।
ভবিষ্যতে খুলবে এমন ব্যবসা খুঁজে দেখা
ভবিষ্যতে খুলতে পারে এমন ব্যবসা সম্পর্কে আপনি বিবরণ জানতে চাইতে পারেন।
সম্ভাব্য
খোলার তারিখে অন্তত মাস উল্লেখ করা থাকলে এবং সেটি ৯০ দিনের কম সময়ের মধ্যে হলে, 'আশেপাশের লোকেশন সার্চ' (নতুন) openingDate ফিল্ডে অটো-ফিল করবে।
নিচে দেওয়া উদাহরণে নিউ মিডোজ, আইডাহোতে ভবিষ্যতে খুলতে চলা একটি ব্যবসার জন্য 'আশেপাশের সার্চ (নতুন)' কোয়েরি দেখানো হয়েছে:
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"] }, ... ] }
এটি ব্যবহার করে দেখুন!
API এক্সপ্লোরার আপনাকে স্যাম্পেল অনুরোধ করতে দেয় যাতে আপনি API ও API বিকল্পগুলির সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে API আইকন api বেছে নিন।
ঐচ্ছিকভাবে অনুরোধের প্যারামিটার এডিট করুন।
এক্সিকিউট করুন বোতামটি বেছে নিন। ডায়ালগে, অনুরোধ করার জন্য আপনি যে অ্যাকাউন্ট ব্যবহার করতে চান সেটি বেছে নিন।
API এক্সপ্লোরার প্যানেলে, API এক্সপ্লোরার উইন্ডো বড় করতে, 'ফুলস্ক্রিন' আইকন ফুলস্ক্রিন বেছে নিন।