এই পণ্য বা বৈশিষ্ট্য উত্তরাধিকার স্থিতি আছে. লিগ্যাসি স্ট্যাটাস এবং কীভাবে লিগ্যাসি থেকে নতুন পরিষেবাগুলিতে স্থানান্তর করা যায় সে সম্পর্কে আরও তথ্যের জন্য, লিগ্যাসি পণ্য এবং বৈশিষ্ট্যগুলি দেখুন৷

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Directions API (Legacy) ওয়েব পরিষেবা ব্যবহারের সর্বোত্তম অনুশীলন

গুগল ম্যাপস প্ল্যাটফর্ম ওয়েব সার্ভিসগুলো হলো গুগল সার্ভিসগুলোর একগুচ্ছ HTTP ইন্টারফেস, যা আপনার ম্যাপ অ্যাপ্লিকেশনগুলোর জন্য ভৌগোলিক ডেটা সরবরাহ করে।

এই নির্দেশিকাটি আপনার ওয়েব পরিষেবা অনুরোধগুলি সেট আপ করতে এবং পরিষেবা প্রতিক্রিয়াগুলি প্রক্রিয়া করার জন্য দরকারী কিছু সাধারণ পদ্ধতি বর্ণনা করে। Directions API (Legacy)-এর সম্পূর্ণ ডকুমেন্টেশনের জন্য ডেভেলপারের নির্দেশিকা দেখুন।

ওয়েব সার্ভিস বলতে কী বোঝায়?

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

ম্যাপস এপিআই ওয়েব সার্ভিসগুলো নির্দিষ্ট ইউআরএল-এ HTTP(S) রিকোয়েস্ট পাঠায় এবং আর্গুমেন্ট হিসেবে ইউআরএল প্যারামিটার এবং/অথবা JSON-ফরম্যাটের POST ডেটা প্রেরণ করে। সাধারণত, এই সার্ভিসগুলো আপনার অ্যাপ্লিকেশনের পার্সিং এবং/অথবা প্রসেসিং-এর জন্য রেসপন্স বডিতে JSON অথবা XML ফরম্যাটে ডেটা ফেরত দেয়।

একটি সাধারণ Directions API (Legacy) অনুরোধ সাধারণত নিম্নলিখিত আকারের হয়ে থাকে:

https://maps.googleapis.com/maps/api/directions/output?parameters

যেখানে output প্রতিক্রিয়ার ফরম্যাট নির্দেশ করে (সাধারণত json বা xml )।

দ্রষ্টব্য : সমস্ত Directions API (Legacy) অ্যাপ্লিকেশনের জন্য প্রমাণীকরণ প্রয়োজন। প্রমাণীকরণ ক্রেডেনশিয়াল সম্পর্কে আরও তথ্য জানুন।

SSL/TLS অ্যাক্সেস

যেসব গুগল ম্যাপস প্ল্যাটফর্ম অনুরোধে এপিআই কী ব্যবহার করা হয় বা ব্যবহারকারীর ডেটা থাকে, সেগুলোর জন্য HTTPS আবশ্যক। HTTP-এর মাধ্যমে করা সংবেদনশীল ডেটাযুক্ত অনুরোধ প্রত্যাখ্যান করা হতে পারে।

একটি বৈধ URL তৈরি করা

আপনার মনে হতে পারে যে একটি "বৈধ" ইউআরএল স্বতঃসিদ্ধ, কিন্তু ব্যাপারটা ঠিক তেমন নয়। উদাহরণস্বরূপ, ব্রাউজারের অ্যাড্রেস বারে প্রবেশ করানো একটি ইউআরএল-এ বিশেষ অক্ষর থাকতে পারে (যেমন "上海+中國" ); প্রেরণের আগে ব্রাউজারকে অভ্যন্তরীণভাবে সেই অক্ষরগুলোকে একটি ভিন্ন এনকোডিং-এ অনুবাদ করতে হয়। একইভাবে, যে কোনো কোড যা UTF-8 ইনপুট তৈরি বা গ্রহণ করে, সেটি UTF-8 অক্ষরযুক্ত ইউআরএলগুলোকে "বৈধ" হিসেবে গণ্য করতে পারে, কিন্তু ওয়েব সার্ভারে পাঠানোর আগে সেই অক্ষরগুলোকেও অনুবাদ করার প্রয়োজন হয়। এই প্রক্রিয়াটিকে ইউআরএল-এনকোডিং বা পার্সেন্ট-এনকোডিং বলা হয়।

সতর্কতা : ব্রাউজার এবং/অথবা পরিষেবাগুলি অনুরোধ পাঠানোর আগে স্বয়ংক্রিয়ভাবে একটি অনুরোধ URI-কে URL-এনকোড করতে পারে। যে API-গুলি ক্রিপ্টোগ্রাফিক অনুরোধ স্বাক্ষর ব্যবহার করে, সেগুলিতে স্বাক্ষরের পরে URL-এনকোডিং অনুরোধটিকে পরিবর্তন করলে স্বাক্ষরটি অবৈধ হয়ে যেতে পারে। এই সমস্যাটি এড়াতে, অনুরোধটি স্বাক্ষর করার আগে সর্বদা আপনার কোয়েরি স্ট্রিং URL-এনকোড করুন।

বিশেষ চরিত্র

আমাদের বিশেষ অক্ষরগুলো অনুবাদ করতে হয়, কারণ সমস্ত URL-কে ইউনিফর্ম রিসোর্স আইডেন্টিফায়ার (URI) স্পেসিফিকেশন দ্বারা নির্দিষ্ট সিনট্যাক্স মেনে চলতে হয়। এর অর্থ হলো, URL-এ অবশ্যই ASCII অক্ষরের একটি বিশেষ উপসেট থাকতে হবে: পরিচিত আলফানিউমেরিক প্রতীকগুলো এবং URL-এর মধ্যে কন্ট্রোল ক্যারেক্টার হিসেবে ব্যবহারের জন্য কিছু সংরক্ষিত অক্ষর। এই সারণিতে এই অক্ষরগুলোর একটি সংক্ষিপ্ত বিবরণ দেওয়া হলো:

বৈধ URL অক্ষরগুলির সারাংশ

সেট	চরিত্রগুলি	URL ব্যবহার
আলফানিউমেরিক	abcdefghijklm nopqrstuvwxyz ABCDEFGHIJKLM NOPQRSTUVWXYZ 0 1 2 3 4 5 6 7 8 9	টেক্সট স্ট্রিং, স্কিম ব্যবহার ( `http` ), পোর্ট ( `8080` ), ইত্যাদি।
অসংরক্ষিত	- _ . ~	টেক্সট স্ট্রিং
সংরক্ষিত	! * ' ( ) ; : @ & = + $ , / ? % # [ ]	নিয়ন্ত্রণ অক্ষর এবং/অথবা পাঠ্য স্ট্রিং

একটি বৈধ ইউআরএল তৈরি করার সময়, আপনাকে অবশ্যই নিশ্চিত করতে হবে যে এতে শুধুমাত্র সারণিতে দেখানো অক্ষরগুলোই রয়েছে। এই অক্ষরগুচ্ছ ব্যবহার করার জন্য একটি ইউআরএলকে উপযুক্ত করতে গেলে সাধারণত দুটি সমস্যা দেখা দেয়—একটি হলো অক্ষর বাদ পড়া এবং অন্যটি হলো প্রতিস্থাপন:

আপনি যে অক্ষরগুলো পরিচালনা করতে চান, সেগুলো উপরের সেটের বাইরে থাকে। উদাহরণস্বরূপ,上海+中國-এর মতো বিদেশী ভাষার অক্ষরগুলোকে উপরের অক্ষরগুলো ব্যবহার করে এনকোড করতে হয়। প্রচলিত রীতি অনুযায়ী, স্পেস (যা URL-এর মধ্যে অনুমোদিত নয়) প্রায়শই প্লাস '+' চিহ্ন ব্যবহার করে প্রকাশ করা হয়।
উপরোক্ত সেটের মধ্যে কিছু অক্ষর সংরক্ষিত অক্ষর হিসেবে বিদ্যমান, কিন্তু সেগুলোকে আক্ষরিকভাবে ব্যবহার করতে হয়। উদাহরণস্বরূপ, URL-এ কোয়েরি স্ট্রিং-এর শুরু বোঝাতে '? ? চিহ্নটি ব্যবহৃত হয়; যদি আপনি "? and the Mysterions" স্ট্রিংটি ব্যবহার করতে চান, তাহলে আপনাকে '?' অক্ষরটি এনকোড করতে হবে।

URL-এনকোড করার জন্য সমস্ত অক্ষরকে একটি '%' অক্ষর এবং তাদের UTF-8 অক্ষরের সাথে সঙ্গতিপূর্ণ একটি দুই-অক্ষরের হেক্স ভ্যালু ব্যবহার করে এনকোড করা হয়। উদাহরণস্বরূপ, UTF-8-এ上海+中國URL-এনকোড করলে হবে %E4%B8%8A%E6%B5%B7%2B%E4%B8%AD%E5%9C%8B । ? and the Mysterians স্ট্রিংটিকে URL-এনকোড করলে হবে %3F+and+the+Mysterians অথবা %3F%20and%20the%20Mysterians ।

সাধারণ অক্ষর যেগুলোর এনকোডিং প্রয়োজন

কিছু সাধারণ অক্ষর যা অবশ্যই এনকোড করতে হবে, সেগুলো হলো:

অনিরাপদ চরিত্র	এনকোড করা মান
মহাকাশ	`%20`
"	`%22`
<	`%3C`
>	`%3E`
#	`%23`
%	`%25`
\|	`%7C`

ব্যবহারকারীর ইনপুট থেকে পাওয়া একটি URL রূপান্তর করা কখনও কখনও বেশ জটিল হতে পারে। উদাহরণস্বরূপ, একজন ব্যবহারকারী "5th&Main St." এর মতো একটি ঠিকানা লিখতে পারেন। সাধারণত, ব্যবহারকারীর দেওয়া যেকোনো ইনপুটকে আক্ষরিক অক্ষর হিসেবে বিবেচনা করে, আপনার URL-টি তার অংশগুলো থেকে তৈরি করা উচিত।

এছাড়াও, গুগল ম্যাপস প্ল্যাটফর্মের সমস্ত ওয়েব সার্ভিস এবং স্ট্যাটিক ওয়েব এপিআই-এর জন্য ইউআরএল ১৬৩৮৪ অক্ষরের মধ্যে সীমাবদ্ধ। বেশিরভাগ সার্ভিসের ক্ষেত্রে, এই অক্ষর সীমা খুব কমই অতিক্রম করা হয়। তবে, মনে রাখবেন যে কিছু নির্দিষ্ট সার্ভিসের বেশ কিছু প্যারামিটার রয়েছে, যার ফলে ইউআরএল দীর্ঘ হতে পারে।

গুগল এপিআই-এর মার্জিত ব্যবহার

ত্রুটিপূর্ণভাবে ডিজাইন করা এপিআই ক্লায়েন্টগুলো ইন্টারনেট এবং গুগলের সার্ভার উভয়ের উপরই প্রয়োজনের চেয়ে বেশি চাপ সৃষ্টি করতে পারে। এই বিভাগে এপিআই ক্লায়েন্টদের জন্য কিছু সর্বোত্তম অনুশীলন উল্লেখ করা হয়েছে। এই সর্বোত্তম অনুশীলনগুলো অনুসরণ করলে, এপিআই-এর অনিচ্ছাকৃত অপব্যবহারের কারণে আপনার অ্যাপ্লিকেশনটি ব্লক হওয়া এড়ানো সম্ভব।

এক্সপোনেনশিয়াল ব্যাকঅফ

বিরল ক্ষেত্রে আপনার অনুরোধটি পূরণ করতে কোনো সমস্যা হতে পারে; আপনি একটি 4XX বা 5XX HTTP রেসপন্স কোড পেতে পারেন, অথবা আপনার ক্লায়েন্ট এবং গুগলের সার্ভারের মধ্যে কোথাও TCP সংযোগটি ব্যর্থ হতে পারে। প্রায়শই অনুরোধটি পুনরায় চেষ্টা করা লাভজনক, কারণ মূল অনুরোধটি ব্যর্থ হলেও পরবর্তী অনুরোধটি সফল হতে পারে। তবে, গুগলের সার্ভারগুলিতে বারবার অনুরোধ পাঠিয়ে একটি চক্র তৈরি না করাটা গুরুত্বপূর্ণ। এই চক্রাকার আচরণ আপনার ক্লায়েন্ট এবং গুগলের মধ্যকার নেটওয়ার্ককে অতিরিক্ত ভারাক্রান্ত করতে পারে, যা অনেক পক্ষের জন্য সমস্যা সৃষ্টি করে।

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

উদাহরণস্বরূপ, এমন একটি অ্যাপ্লিকেশনের কথা ভাবুন যা টাইম জোন এপিআই-এর কাছে এই অনুরোধটি করতে চায়:

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY

নিম্নলিখিত পাইথন উদাহরণটি দেখায় কিভাবে এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে অনুরোধটি করতে হয়:

import json
import time
import urllib.error
import urllib.parse
import urllib.request

# The maps_key defined below isn't a valid Google Maps API key.
# You need to get your own API key.
# See https://developers.google.com/maps/documentation/timezone/get-api-key
API_KEY = "YOUR_KEY_HERE"
TIMEZONE_BASE_URL = "https://maps.googleapis.com/maps/api/timezone/json"


def timezone(lat, lng, timestamp):

    # Join the parts of the URL together into one string.
    params = urllib.parse.urlencode(
        {"location": f"{lat},{lng}", "timestamp": timestamp, "key": API_KEY,}
    )
    url = f"{TIMEZONE_BASE_URL}?{params}"

    current_delay = 0.1  # Set the initial retry delay to 100ms.
    max_delay = 5  # Set the maximum retry delay to 5 seconds.

    while True:
        try:
            # Get the API response.
            response = urllib.request.urlopen(url)
        except urllib.error.URLError:
            pass  # Fall through to the retry loop.
        else:
            # If we didn't get an IOError then parse the result.
            result = json.load(response)

            if result["status"] == "OK":
                return result["timeZoneId"]
            elif result["status"] != "UNKNOWN_ERROR":
                # Many API errors cannot be fixed by a retry, e.g. INVALID_REQUEST or
                # ZERO_RESULTS. There is no point retrying these requests.
                raise Exception(result["error_message"])

        if current_delay > max_delay:
            raise Exception("Too many retry attempts.")

        print("Waiting", current_delay, "seconds before retrying.")

        time.sleep(current_delay)
        current_delay *= 2  # Increase the delay each time we retry.


if __name__ == "__main__":
    tz = timezone(39.6034810, -119.6822510, 1331161200)
    print(f"Timezone: {tz}")

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

সিঙ্ক্রোনাইজড অনুরোধ

গুগলের এপিআই-গুলোতে বিপুল সংখ্যক একযোগে পাঠানো অনুরোধকে গুগলের পরিকাঠামোর উপর একটি ডিস্ট্রিবিউটেড ডিনায়াল অফ সার্ভিস (DDoS) আক্রমণ বলে মনে হতে পারে এবং সেই অনুযায়ী ব্যবস্থা নেওয়া হতে পারে। এটি এড়ানোর জন্য, আপনাকে নিশ্চিত করতে হবে যে ক্লায়েন্টগুলোর মধ্যে এপিআই অনুরোধগুলো একযোগে পাঠানো না হয়।

উদাহরণস্বরূপ, এমন একটি অ্যাপ্লিকেশনের কথা ভাবুন যা বর্তমান টাইম জোনের সময় প্রদর্শন করে। এই অ্যাপ্লিকেশনটি সম্ভবত ক্লায়েন্ট অপারেটিং সিস্টেমে মিনিটের শুরুতে একটি অ্যালার্ম সেট করবে, যাতে প্রদর্শিত সময় আপডেট করা যায়। সেই অ্যালার্ম সম্পর্কিত প্রক্রিয়াকরণের অংশ হিসেবে অ্যাপ্লিকেশনটির কোনো এপিআই (API) কল করা উচিত নয় ।

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

এর পরিবর্তে, একটি সম্ভাব্য ভালো ডিজাইন হলো এলোমেলোভাবে নির্বাচিত একটি সময়ে দ্বিতীয় একটি অ্যালার্ম সেট করা। যখন এই দ্বিতীয় অ্যালার্মটি বাজে, তখন অ্যাপ্লিকেশনটি তার প্রয়োজনীয় এপিআই (API) কল করে এবং ফলাফলগুলো সংরক্ষণ করে। মিনিটের শুরুতে যখন অ্যাপ্লিকেশনটি তার ডিসপ্লে আপডেট করতে চায়, তখন এটি এপিআই-কে আবার কল না করে পূর্বে সংরক্ষিত ফলাফলগুলো ব্যবহার করে। এই পদ্ধতিতে, এপিআই কলগুলো সময়ের সাথে সমানভাবে ছড়িয়ে থাকে। এছাড়াও, ডিসপ্লে আপডেট করার সময় এপিআই কলগুলো রেন্ডারিংয়ে কোনো বিলম্ব ঘটায় না।

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

প্রতিক্রিয়া প্রক্রিয়াকরণ

দ্রষ্টব্য : যেহেতু একটি ওয়েব পরিষেবা অনুরোধের সাথে প্রাপ্ত প্রতিটি প্রতিক্রিয়ার সঠিক বিন্যাস নিশ্চিত করা যায় না (কিছু উপাদান অনুপস্থিত থাকতে পারে বা একাধিক স্থানে থাকতে পারে), তাই আপনার কখনই ধরে নেওয়া উচিত নয় যে বিভিন্ন কোয়েরির জন্য প্রাপ্ত প্রতিক্রিয়ার বিন্যাস একই হবে। এর পরিবর্তে, আপনার উচিত প্রতিক্রিয়াটি প্রক্রিয়া করা এবং এক্সপ্রেশনের মাধ্যমে উপযুক্ত মান নির্বাচন করা।

এই অংশে আলোচনা করা হয়েছে কিভাবে ওয়েব সার্ভিসের প্রতিক্রিয়া থেকে এই মানগুলি গতিশীলভাবে বের করা যায়।

গুগল ম্যাপস ওয়েব সার্ভিস যে প্রতিক্রিয়া প্রদান করে তা বোঝা সহজ, কিন্তু ঠিক ব্যবহারকারী-বান্ধব নয়। কোনো কোয়েরি চালানোর সময়, একগুচ্ছ ডেটা দেখানোর পরিবর্তে, আপনি সম্ভবত কয়েকটি নির্দিষ্ট মান বের করে আনতে চাইবেন। সাধারণত, আপনি ওয়েব সার্ভিস থেকে প্রাপ্ত প্রতিক্রিয়াগুলো পার্স করে শুধুমাত্র আপনার প্রয়োজনীয় মানগুলোই বের করে আনতে চাইবেন।

আপনি আউটপুট XML নাকি JSON ফরম্যাটে ফেরত দিচ্ছেন, তার উপর আপনার ব্যবহৃত পার্সিং স্কিম নির্ভর করে। JSON রেসপন্সগুলো যেহেতু আগে থেকেই জাভাস্ক্রিপ্ট অবজেক্ট আকারে থাকে, তাই ক্লায়েন্টে সরাসরি জাভাস্ক্রিপ্টের মধ্যেই সেগুলো প্রসেস করা যেতে পারে। XML রেসপন্সগুলো প্রসেস করার জন্য একটি XML প্রসেসর এবং XML ফরম্যাটের ভেতরের এলিমেন্টগুলোকে অ্যাক্সেস করার জন্য একটি XML কোয়েরি ল্যাঙ্গুয়েজ ব্যবহার করা উচিত। আমরা নিম্নলিখিত উদাহরণগুলোতে XPath ব্যবহার করেছি, কারণ এটি XML প্রসেসিং লাইব্রেরিগুলোতে সাধারণত সমর্থিত থাকে।

XPath ব্যবহার করে XML প্রক্রিয়াকরণ

XML হলো ডেটা আদান-প্রদানের জন্য ব্যবহৃত একটি তুলনামূলকভাবে পরিণত কাঠামোগত তথ্য ফরম্যাট। যদিও এটি JSON-এর মতো হালকা নয়, XML আরও বেশি ল্যাঙ্গুয়েজ সাপোর্ট এবং আরও শক্তিশালী টুলস প্রদান করে। উদাহরণস্বরূপ, জাভাতে XML প্রসেস করার কোড javax.xml প্যাকেজের মধ্যে বিল্ট-ইন থাকে।

এক্সএমএল রেসপন্স প্রসেস করার সময়, এক্সএমএল মার্কআপের মধ্যে এলিমেন্টগুলো একটি নির্দিষ্ট অবস্থানে রয়েছে বলে ধরে না নিয়ে, এক্সএমএল ডকুমেন্টের নোডগুলো নির্বাচন করার জন্য একটি উপযুক্ত কোয়েরি ল্যাঙ্গুয়েজ ব্যবহার করা উচিত। এক্সপাথ (XPath) হলো একটি ল্যাঙ্গুয়েজ সিনট্যাক্স যা একটি এক্সএমএল ডকুমেন্টের মধ্যে নোড এবং এলিমেন্টগুলোকে স্বতন্ত্রভাবে বর্ণনা করার জন্য ব্যবহৃত হয়। এক্সপাথ এক্সপ্রেশন আপনাকে এক্সএমএল রেসপন্স ডকুমেন্টের মধ্যে নির্দিষ্ট কন্টেন্ট শনাক্ত করতে সাহায্য করে।

এক্সপাথ এক্সপ্রেশন

একটি শক্তিশালী পার্সিং স্কিম তৈরি করার জন্য XPath সম্পর্কে কিছুটা ধারণা থাকা অত্যন্ত সহায়ক। এই অংশে আলোচনা করা হবে কিভাবে একটি XML ডকুমেন্টের ভেতরের এলিমেন্টগুলোকে XPath ব্যবহার করে অ্যাক্সেস করা হয়, যা আপনাকে একাধিক এলিমেন্ট অ্যাক্সেস করতে এবং জটিল কোয়েরি তৈরি করতে সাহায্য করবে।

XPath একটি XML ডকুমেন্টের মধ্যে এলিমেন্ট নির্বাচন করতে এক্সপ্রেশন ব্যবহার করে, যার সিনট্যাক্স ডিরেক্টরি পাথের জন্য ব্যবহৃত সিনট্যাক্সের অনুরূপ। এই এক্সপ্রেশনগুলো একটি XML ডকুমেন্ট ট্রি-এর মধ্যে এলিমেন্ট শনাক্ত করে, যা DOM-এর মতো একটি স্তরক্রমিক ট্রি। সাধারণত, XPath এক্সপ্রেশনগুলো গ্রিডি হয়, যার অর্থ হলো এগুলো প্রদত্ত শর্ত পূরণকারী সমস্ত নোডের সাথে মিল খুঁজে নেবে।

আমাদের উদাহরণগুলো ব্যাখ্যা করার জন্য আমরা নিম্নলিখিত বিমূর্ত XML ব্যবহার করব:

<WebServiceResponse>
 <status>OK</status>
 <result>
  <type>sample</type>
  <name>Sample XML</name>
  <location>
   <lat>37.4217550</lat>
   <lng>-122.0846330</lng>
  </location>
 </result>
 <result>
  <message>The secret message</message>
 </result>
</WebServiceResponse>

এক্সপ্রেশনে নোড নির্বাচন

XPath সিলেকশন নোড নির্বাচন করে। রুট নোড পুরো ডকুমেন্টটিকে অন্তর্ভুক্ত করে। আপনি বিশেষ এক্সপ্রেশন " / " ব্যবহার করে এই নোডটি নির্বাচন করেন। মনে রাখবেন যে রুট নোড আপনার XML ডকুমেন্টের শীর্ষ-স্তরের নোড নয়; প্রকৃতপক্ষে, এটি এই শীর্ষ-স্তরের এলিমেন্টের এক স্তর উপরে অবস্থান করে এবং এটিকে অন্তর্ভুক্ত করে।

এলিমেন্ট নোডগুলো এক্সএমএল ডকুমেন্ট ট্রি-এর অন্তর্ভুক্ত বিভিন্ন উপাদানকে উপস্থাপন করে। উদাহরণস্বরূপ, একটি <WebServiceResponse> এলিমেন্ট আমাদের উপরের নমুনা সার্ভিসে ফেরত আসা শীর্ষ-স্তরের এলিমেন্টকে প্রতিনিধিত্ব করে। আপনি অ্যাবসোলিউট বা রিলেটিভ পাথের মাধ্যমে স্বতন্ত্র নোড নির্বাচন করতে পারেন, যা শুরুতে একটি " / " অক্ষরের উপস্থিতি বা অনুপস্থিতি দ্বারা নির্দেশিত হয়।

পরম পথ: " /WebServiceResponse/result " এক্সপ্রেশনটি <WebServiceResponse> নোডের অধীনস্থ সমস্ত <result> নোডকে নির্বাচন করে। (উল্লেখ্য যে, এই উভয় উপাদানই মূল নোড " / " থেকে উদ্ভূত।)
বর্তমান কনটেক্সট থেকে আপেক্ষিক পাথ: " result " এক্সপ্রেশনটি বর্তমান কনটেক্সটের মধ্যে থাকা যেকোনো <result> এলিমেন্টের সাথে মিলবে। সাধারণত, আপনার কনটেক্সট নিয়ে চিন্তা করার প্রয়োজন নেই, কারণ আপনি সাধারণত একটিমাত্র এক্সপ্রেশনের মাধ্যমেই ওয়েব সার্ভিসের ফলাফল প্রসেস করে থাকেন।

এই এক্সপ্রেশনগুলোর যেকোনো একটিকে একটি ওয়াইল্ডকার্ড পাথ যোগ করে বর্ধিত করা যেতে পারে, যা একটি ডাবল-স্ল্যাশ (" // ") দ্বারা নির্দেশিত হয়। এই ওয়াইল্ডকার্ডটি নির্দেশ করে যে মধ্যবর্তী পাথে শূন্য বা তার বেশি সংখ্যক এলিমেন্ট ম্যাচ করতে পারে। উদাহরণস্বরূপ, XPath এক্সপ্রেশন " //formatted_address ," বর্তমান ডকুমেন্টের সেই নামের সমস্ত নোডের সাথে ম্যাচ করবে। এক্সপ্রেশন //viewport//lat সেই সমস্ত <lat> এলিমেন্টের সাথে ম্যাচ করবে যেগুলো <viewport> কে প্যারেন্ট হিসেবে ট্রেস করতে পারে।

ডিফল্টরূপে, XPath এক্সপ্রেশন সমস্ত এলিমেন্টের সাথে মেলে। আপনি একটি প্রেডিকেট প্রদান করে এক্সপ্রেশনটিকে একটি নির্দিষ্ট এলিমেন্টের সাথে মেলানোর জন্য সীমাবদ্ধ করতে পারেন, যা বর্গাকার বন্ধনীতে ( [] ) আবদ্ধ থাকে। উদাহরণস্বরূপ, XPath এক্সপ্রেশন " /GeocodeResponse/result[2] সর্বদা দ্বিতীয় ফলাফলটি ফেরত দেয়।

অভিব্যক্তির ধরণ
মূল নোড	এক্সপাথ এক্সপ্রেশন: " `/` " নির্বাচন: <WebServiceResponse> <status>OK</status> <result> <type>sample</type> <name>Sample XML</name> <location> <lat>37.4217550</lat> <lng>-122.0846330</lng> </location> </result> <result> <message>The secret message</message> </result> </WebServiceResponse>
পরম পথ	এক্সপাথ এক্সপ্রেশন: " `/WebServiceResponse/result` " নির্বাচন: <result> <type>sample</type> <name>Sample XML</name> <location> <lat>37.4217550</lat> <lng>-122.0846330</lng> </location> </result> <result> <message>The secret message</message> </result>
ওয়াইল্ডকার্ড সহ পথ	এক্সপাথ এক্সপ্রেশন: " `/WebServiceResponse//location` " নির্বাচন: <location> <lat>37.4217550</lat> <lng>-122.0846330</lng> </location>
বিধেয় সহ পথ	XPath এক্সপ্রেশন: " `/WebServiceResponse/result[2]/message` " নির্বাচন: <message>The secret message</message>
প্রথম `result` সকল সরাসরি সন্তান	XPath এক্সপ্রেশন: " `/WebServiceResponse/result[1]/` " নির্বাচন:* <type>sample</type> <name>Sample XML</name> <location> <lat>37.4217550</lat> <lng>-122.0846330</lng> </location>
এমন একটি `result` `name` যার `type` টেক্সট হলো "sample"।	XPath এক্সপ্রেশন: " `/WebServiceResponse/result[type/text()='sample']/name` " নির্বাচন: Sample XML

এটা মনে রাখা গুরুত্বপূর্ণ যে, এলিমেন্ট নির্বাচন করার সময় আপনি নোডগুলো নির্বাচন করেন, শুধু সেই অবজেক্টগুলোর ভেতরের টেক্সট নয়। সাধারণত, আপনি মিলে যাওয়া সমস্ত নোডের ওপর দিয়ে পুনরাবৃত্তি করে টেক্সটটি বের করে আনতে চাইবেন। আপনি সরাসরি টেক্সট নোডগুলোও মেলাতে পারেন; নিচে ‘টেক্সট নোড’ অংশটি দেখুন।

উল্লেখ্য যে, XPath অ্যাট্রিবিউট নোডও সমর্থন করে; তবে, গুগল ম্যাপসের সমস্ত ওয়েব পরিষেবা অ্যাট্রিবিউটবিহীন এলিমেন্ট সরবরাহ করে, তাই অ্যাট্রিবিউট মেলানোর প্রয়োজন হয় না।

এক্সপ্রেশনে টেক্সট নির্বাচন

একটি XML ডকুমেন্টের টেক্সট XPath এক্সপ্রেশনে একটি টেক্সট নোড অপারেটরের মাধ্যমে নির্দিষ্ট করা হয়। এই অপারেটর " text() " নির্দেশিত নোড থেকে টেক্সট নিষ্কাশন নির্দেশ করে। উদাহরণস্বরূপ, XPath এক্সপ্রেশন " //formatted_address/text() " <formatted_address> এলিমেন্টের ভেতরের সমস্ত টেক্সট ফেরত দেবে।

অভিব্যক্তির ধরণ
সমস্ত টেক্সট নোড (স্পেস সহ)	এক্সপাথ এক্সপ্রেশন: " `//text()` " নির্বাচন: sample Sample XML 37.4217550 -122.0846330 The secret message
পাঠ্য নির্বাচন	XPath এক্সপ্রেশন: " `/WebServiceRequest/result[2]/message/text()` " নির্বাচন: The secret message
প্রসঙ্গ সংবেদনশীল নির্বাচন	XPath এক্সপ্রেশন: " `/WebServiceRequest/result[type/text() = 'sample']/name/text()` " নির্বাচন: Sample XML

বিকল্পভাবে, আপনি একটি এক্সপ্রেশন মূল্যায়ন করে এক সেট নোড ফেরত দিতে পারেন এবং তারপর সেই 'নোড সেট'-এর উপর পুনরাবৃত্তি করে প্রতিটি নোড থেকে টেক্সট বের করে নিতে পারেন। আমরা নীচের উদাহরণে এই পদ্ধতিটি ব্যবহার করেছি।

XPath সম্পর্কে আরও তথ্যের জন্য, XPath W3C স্পেসিফিকেশন দেখুন।

জাভাতে XPath মূল্যায়ন

জাভাতে javax.xml.xpath.* প্যাকেজের মধ্যে XML পার্সিং এবং XPath এক্সপ্রেশন ব্যবহারের ব্যাপক সমর্থন রয়েছে। সেই কারণে, এই বিভাগের নমুনা কোডটিতে XML কীভাবে পরিচালনা করতে হয় এবং XML পরিষেবা প্রতিক্রিয়া থেকে ডেটা কীভাবে পার্স করতে হয় তা দেখানোর জন্য জাভা ব্যবহার করা হয়েছে।

আপনার জাভা কোডে XPath ব্যবহার করতে হলে, প্রথমে আপনাকে একটি XPathFactory এর ইনস্ট্যান্স তৈরি করতে হবে এবং একটি XPath অবজেক্ট বানানোর জন্য সেই ফ্যাক্টরিতে newXPath() কল করতে হবে। এরপর এই অবজেক্টটি evaluate() মেথড ব্যবহার করে প্রদত্ত XML এবং XPath এক্সপ্রেশনগুলো প্রসেস করতে পারে।

XPath এক্সপ্রেশন মূল্যায়ন করার সময়, নিশ্চিত করুন যে আপনি ফেরত আসা যেকোনো সম্ভাব্য "নোড সেট"-এর উপর পুনরাবৃত্তি করছেন। যেহেতু এই ফলাফলগুলি জাভা কোডে DOM নোড হিসাবে ফেরত আসে, তাই আপনার উচিত এই ধরনের একাধিক মান একটি NodeList অবজেক্টের মধ্যে ধারণ করা এবং সেই নোডগুলি থেকে যেকোনো টেক্সট বা মান বের করার জন্য সেই অবজেক্টটির উপর পুনরাবৃত্তি করা।

নিম্নলিখিত কোডটিতে দেখানো হয়েছে কীভাবে একটি XPath অবজেক্ট তৈরি করতে হয়, তাতে XML ও একটি XPath এক্সপ্রেশন অ্যাসাইন করতে হয় এবং প্রাসঙ্গিক বিষয়বস্তু প্রিন্ট করার জন্য এক্সপ্রেশনটি ইভ্যালুয়েট করতে হয়।

import org.xml.sax.InputSource;
import org.w3c.dom.*;
import javax.xml.xpath.*;
import java.io.*;

public class SimpleParser {

  public static void main(String[] args) throws IOException {

	XPathFactory factory = XPathFactory.newInstance();

    XPath xpath = factory.newXPath();

    try {
      System.out.print("Web Service Parser 1.0\n");

      // In practice, you'd retrieve your XML via an HTTP request.
      // Here we simply access an existing file.
      File xmlFile = new File("XML_FILE");

      // The xpath evaluator requires the XML be in the format of an InputSource
	  InputSource inputXml = new InputSource(new FileInputStream(xmlFile));

      // Because the evaluator may return multiple entries, we specify that the expression
      // return a NODESET and place the result in a NodeList.
      NodeList nodes = (NodeList) xpath.evaluate("XPATH_EXPRESSION", inputXml, XPathConstants.NODESET);

      // We can then iterate over the NodeList and extract the content via getTextContent().
      // NOTE: this will only return text for element nodes at the returned context.
      for (int i = 0, n = nodes.getLength(); i < n; i++) {
        String nodeString = nodes.item(i).getTextContent();
        System.out.print(nodeString);
        System.out.print("\n");
      }
    } catch (XPathExpressionException ex) {
	  System.out.print("XPath Error");
    } catch (FileNotFoundException ex) {
      System.out.print("File Error");
    }
  }
}