ড্রাইভিং দূরত্ব গণনা করুন & মিটারকে মাইলে রূপান্তর করুন

কোডিং স্তর : শিক্ষানবিস
সময়কাল : ১০ মিনিট
প্রকল্পের ধরণ : কাস্টম মেনু সহ কাস্টম ফাংশন এবং অটোমেশন

উদ্দেশ্য

• সমাধানটি কী কাজ করে তা বুঝুন।
• সলিউশনের মধ্যে অ্যাপস স্ক্রিপ্ট সার্ভিসগুলো কী কাজ করে তা বুঝুন।
• স্ক্রিপ্টটি সেট আপ করুন।
• স্ক্রিপ্টটি চালান।

এই সমাধান সম্পর্কে

কাস্টম ফাংশন ব্যবহার করে, আপনি দুটি অবস্থানের মধ্যে গাড়িতে যাওয়ার দূরত্ব গণনা করতে এবং সেই দূরত্বকে মিটার থেকে মাইলে রূপান্তর করতে পারেন। একটি অতিরিক্ত অটোমেশন একটি কাস্টম মেনু প্রদান করে, যা আপনাকে একটি নতুন শীটে শুরুর ঠিকানা থেকে শেষের ঠিকানা পর্যন্ত ধাপে ধাপে দিকনির্দেশনা যোগ করার সুযোগ দেয়।

এটি কীভাবে কাজ করে

স্ক্রিপ্টটি দুটি কাস্টম ফাংশন এবং একটি অটোমেশন ব্যবহার করে:

• drivingDistance(origin, destination) ফাংশনটি দুটি অবস্থানের মধ্যে গাড়ি চালানোর দিকনির্দেশনা গণনা করতে Maps পরিষেবা ব্যবহার করে এবং দুটি ঠিকানার মধ্যকার দূরত্ব মিটারে ফেরত দেয়।
• metersToMiles(meters) ফাংশনটি একটি নির্দিষ্ট সংখ্যক মিটারের জন্য সমতুল্য মাইলের পরিমাণ গণনা করে।
• অটোমেশনটি ব্যবহারকারীকে জিজ্ঞাসা করে যে গাড়ি চালানোর দিকনির্দেশনা গণনা করার জন্য শুরু এবং শেষের ঠিকানার কোন সারিটি ব্যবহার করতে হবে এবং ধাপে ধাপে গাড়ি চালানোর দিকনির্দেশনাগুলো একটি নতুন শীটে যোগ করে দেয়।

অ্যাপস স্ক্রিপ্ট পরিষেবা

এই সমাধানটি নিম্নলিখিত পরিষেবাগুলি ব্যবহার করে:

• স্প্রেডশিট পরিষেবা – এটি কাস্টম মেনু যোগ করে, এই সমাধানটি পরীক্ষা করার জন্য ডেমো ডেটা যোগ করে এবং স্ক্রিপ্টটি যখন ড্রাইভিং দিকনির্দেশনা যোগ করে তখন নতুন শীটগুলোকে ফরম্যাট করে।
• বেস সার্ভিস – এটি Browser ক্লাস ব্যবহার করে ব্যবহারকারীকে দিকনির্দেশনার জন্য সারি নম্বর প্রবেশ করতে অনুরোধ করে এবং কোনো ত্রুটি ঘটলে ব্যবহারকারীকে সতর্ক করে।
• ইউটিলিটি সার্ভিস – ব্যবহারকারীর নির্দিষ্ট করা তথ্য দিয়ে টেমপ্লেটেড স্ট্রিংগুলো আপডেট করে।
• ম্যাপস পরিষেবা – শুরুর ঠিকানা থেকে গন্তব্যের ঠিকানা পর্যন্ত ধাপে ধাপে গুগল ম্যাপসের দিকনির্দেশনা দেয়।

পূর্বশর্ত

এই নমুনাটি ব্যবহার করার জন্য আপনার নিম্নলিখিত পূর্বশর্তগুলো প্রয়োজন:

• একটি গুগল অ্যাকাউন্ট (গুগল ওয়ার্কস্পেস অ্যাকাউন্টের জন্য প্রশাসকের অনুমোদনের প্রয়োজন হতে পারে)।
• ইন্টারনেট সংযোগসহ একটি ওয়েব ব্রাউজার।

স্ক্রিপ্ট সেট আপ করুন

1. "Calculate driving distance and convert meters to miles" স্প্রেডশিটটির একটি কপি তৈরি করুন। এই সমাধানের জন্য অ্যাপস স্ক্রিপ্ট প্রজেক্টটি স্প্রেডশিটটির সাথে সংযুক্ত করা আছে:

   একটি অনুলিপি তৈরি করুন

2. আপনার শীটে হেডার এবং ডেমো ডেটা যোগ করতে, Directions > Prepare sheet-এ ক্লিক করুন। এই কাস্টম মেনুটি প্রদর্শিত হওয়ার জন্য আপনাকে পৃষ্ঠাটি রিফ্রেশ করতে হতে পারে।

3. অনুরোধ করা হলে, স্ক্রিপ্টটিকে অনুমোদন দিন। <<../_snippets/oauth.md>>

4. Directions-এ ক্লিক করুন > আবার শীট প্রস্তুত করুন ।

স্ক্রিপ্টটি চালান

1. C2 সেলে, =DRIVINGDISTANCE(A2,B2) ফর্মুলাটি লিখে এন্টার চাপুন। যদি আপনি এমন কোনো স্থানে থাকেন যেখানে দশমিক কমা ব্যবহৃত হয়, তাহলে আপনাকে এর পরিবর্তে =DRIVINGDISTANCE(A2;B2) লিখতে হতে পারে।
2. D2 সেলে =METERSTOMILES(C2) ফর্মুলাটি লিখে এন্টার চাপুন।
3. (ঐচ্ছিক) শুরু এবং শেষের ঠিকানার অতিরিক্ত সারি যোগ করুন এবং বিভিন্ন স্থানের মধ্যে গাড়িতে ভ্রমণের দূরত্ব গণনা করার জন্য C এবং D কলামের সূত্রগুলো কপি করুন।
4. নির্দেশাবলী > ধাপে ধাপে তৈরি করুন-এ ক্লিক করুন।
5. ডায়ালগ বক্সে, যে ঠিকানাগুলোর জন্য আপনি দিকনির্দেশনা তৈরি করতে চান সেগুলোর সারি নম্বর লিখুন এবং OK-তে ক্লিক করুন।
6. স্ক্রিপ্টটি যে নতুন শীটটি তৈরি করে, তাতে থাকা গাড়ি চালানোর নির্দেশনাগুলো পর্যালোচনা করুন।

কোডটি পর্যালোচনা করুন

এই সলিউশনের অ্যাপস স্ক্রিপ্ট কোড পর্যালোচনা করতে, 'ভিউ সোর্স কোড'- এ ক্লিক করুন:

সোর্স কোড দেখুন

কোড.জিএস

sheets/customFunctions/customFunctions.gs

গিটহাবে দেখুন

/**
 * @OnlyCurrentDoc Limits the script to only accessing the current sheet.
 */

/**
 * A special function that runs when the spreadsheet is open, used to add a
 * custom menu to the spreadsheet.
 */
function onOpen() {
  try {
    const spreadsheet = SpreadsheetApp.getActive();
    const menuItems = [
      { name: "Prepare sheet...", functionName: "prepareSheet_" },
      { name: "Generate step-by-step...", functionName: "generateStepByStep_" },
    ];
    spreadsheet.addMenu("Directions", menuItems);
  } catch (e) {
    // TODO (Developer) - Handle Exception
    console.log(`Failed with error: %s${e.error}`);
  }
}

/**
 * A custom function that converts meters to miles.
 *
 * @param {Number} meters The distance in meters.
 * @return {Number} The distance in miles.
 */
function metersToMiles(meters) {
  if (typeof meters !== "number") {
    return null;
  }
  return (meters / 1000) * 0.621371;
}

/**
 * A custom function that gets the driving distance between two addresses.
 *
 * @param {String} origin The starting address.
 * @param {String} destination The ending address.
 * @return {Number} The distance in meters.
 */
function drivingDistance(origin, destination) {
  const directions = getDirections_(origin, destination);
  return directions.routes[0].legs[0].distance.value;
}

/**
 * A function that adds headers and some initial data to the spreadsheet.
 */
function prepareSheet_() {
  try {
    const sheet = SpreadsheetApp.getActiveSheet().setName("Settings");
    const headers = [
      "Start Address",
      "End Address",
      "Driving Distance (meters)",
      "Driving Distance (miles)",
    ];
    const initialData = [
      "350 5th Ave, New York, NY 10118",
      "405 Lexington Ave, New York, NY 10174",
    ];
    sheet.getRange("A1:D1").setValues([headers]).setFontWeight("bold");
    sheet.getRange("A2:B2").setValues([initialData]);
    sheet.setFrozenRows(1);
    sheet.autoResizeColumns(1, 4);
  } catch (e) {
    // TODO (Developer) - Handle Exception
    console.log(`Failed with error: %s${e.error}`);
  }
}

/**
 * Creates a new sheet containing step-by-step directions between the two
 * addresses on the "Settings" sheet that the user selected.
 */
function generateStepByStep_() {
  try {
    const spreadsheet = SpreadsheetApp.getActive();
    const settingsSheet = spreadsheet.getSheetByName("Settings");
    settingsSheet.activate();

    // Prompt the user for a row number.
    const selectedRow = Browser.inputBox(
      "Generate step-by-step",
      "Please enter the row number of" +
        " the" +
        " addresses to use" +
        ' (for example, "2"):',
      Browser.Buttons.OK_CANCEL,
    );
    if (selectedRow === "cancel") {
      return;
    }
    const rowNumber = Number(selectedRow);
    if (
      Number.isNaN(rowNumber) ||
      rowNumber < 2 ||
      rowNumber > settingsSheet.getLastRow()
    ) {
      Browser.msgBox(
        "Error",
        Utilities.formatString('Row "%s" is not valid.', selectedRow),
        Browser.Buttons.OK,
      );
      return;
    }

    // Retrieve the addresses in that row.
    const row = settingsSheet.getRange(rowNumber, 1, 1, 2);
    const rowValues = row.getValues();
    const origin = rowValues[0][0];
    const destination = rowValues[0][1];
    if (!origin || !destination) {
      Browser.msgBox(
        "Error",
        "Row does not contain two addresses.",
        Browser.Buttons.OK,
      );
      return;
    }

    // Get the raw directions information.
    const directions = getDirections_(origin, destination);

    // Create a new sheet and append the steps in the directions.
    const sheetName = `Driving Directions for Row ${rowNumber}`;
    let directionsSheet = spreadsheet.getSheetByName(sheetName);
    if (directionsSheet) {
      directionsSheet.clear();
      directionsSheet.activate();
    } else {
      directionsSheet = spreadsheet.insertSheet(
        sheetName,
        spreadsheet.getNumSheets(),
      );
    }
    const sheetTitle = Utilities.formatString(
      "Driving Directions from %s to %s",
      origin,
      destination,
    );
    const headers = [
      [sheetTitle, "", ""],
      ["Step", "Distance (Meters)", "Distance (Miles)"],
    ];
    const newRows = [];
    for (const step of directions.routes[0].legs[0].steps) {
      // Remove HTML tags from the instructions.
      const instructions = step.html_instructions
        .replace(/<br>|<div.*?>/g, "\n")
        .replace(/<.*?>/g, "");
      newRows.push([instructions, step.distance.value]);
    }
    directionsSheet.getRange(1, 1, headers.length, 3).setValues(headers);
    directionsSheet
      .getRange(headers.length + 1, 1, newRows.length, 2)
      .setValues(newRows);
    directionsSheet
      .getRange(headers.length + 1, 3, newRows.length, 1)
      .setFormulaR1C1("=METERSTOMILES(R[0]C[-1])");

    // Format the new sheet.
    directionsSheet.getRange("A1:C1").merge().setBackground("#ddddee");
    directionsSheet.getRange("A1:2").setFontWeight("bold");
    directionsSheet.setColumnWidth(1, 500);
    directionsSheet.getRange("B2:C").setVerticalAlignment("top");
    directionsSheet.getRange("C2:C").setNumberFormat("0.00");
    const stepsRange = directionsSheet
      .getDataRange()
      .offset(2, 0, directionsSheet.getLastRow() - 2);
    setAlternatingRowBackgroundColors_(stepsRange, "#ffffff", "#eeeeee");
    directionsSheet.setFrozenRows(2);
    SpreadsheetApp.flush();
  } catch (e) {
    // TODO (Developer) - Handle Exception
    console.log(`Failed with error: %s${e.error}`);
  }
}

/**
 * Sets the background colors for alternating rows within the range.
 * @param {Range} range The range to change the background colors of.
 * @param {string} oddColor The color to apply to odd rows (relative to the
 *     start of the range).
 * @param {string} evenColor The color to apply to even rows (relative to the
 *     start of the range).
 */
function setAlternatingRowBackgroundColors_(range, oddColor, evenColor) {
  const backgrounds = [];
  for (let row = 1; row <= range.getNumRows(); row++) {
    const rowBackgrounds = [];
    for (let column = 1; column <= range.getNumColumns(); column++) {
      if (row % 2 === 0) {
        rowBackgrounds.push(evenColor);
      } else {
        rowBackgrounds.push(oddColor);
      }
    }
    backgrounds.push(rowBackgrounds);
  }
  range.setBackgrounds(backgrounds);
}

/**
 * A shared helper function used to obtain the full set of directions
 * information between two addresses. Uses the Apps Script Maps Service.
 *
 * @param {String} origin The starting address.
 * @param {String} destination The ending address.
 * @return {Object} The directions response object.
 */
function getDirections_(origin, destination) {
  const directionFinder = Maps.newDirectionFinder();
  directionFinder.setOrigin(origin);
  directionFinder.setDestination(destination);
  const directions = directionFinder.getDirections();
  if (directions.status !== "OK") {
    throw directions.error_message;
  }
  return directions;
}

অবদানকারীরা

এই নমুনাটি গুগল ডেভেলপার বিশেষজ্ঞদের সহায়তায় গুগল দ্বারা রক্ষণাবেক্ষণ করা হয়।

পরবর্তী পদক্ষেপ

• গুগল শিটসে কাস্টম ফাংশন
• গুগল ওয়ার্কস্পেসে কাস্টম মেনু