रोडमैप टाइल

रोडमैप टाइल, वेक्टर टॉपोग्राफ़िक डेटा पर आधारित इमेज टाइल होती हैं. इनमें Google की कार्टोग्राफ़िक स्टाइल का इस्तेमाल किया जाता है. इसमें सड़कें, इमारतें, लोकप्रिय जगहें, और राजनैतिक सीमाएं शामिल हैं.

रोडमैप टाइल पाना

सेशन टोकन मिलने के बाद, रोडमैप टाइल के लिए अनुरोध किए जा सकते हैं. सेशन टोकन पूरे सेशन पर लागू होता है. इसलिए, आपको टाइल के अनुरोधों के साथ मैप के विकल्पों की जानकारी देने की ज़रूरत नहीं है.

यहां दिए गए कोड सैंपल में, रोडमैप टाइल के लिए सामान्य सेशन टोकन अनुरोध दिखाया गया है.

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

एचटीटीपीएस जीईटी अनुरोध करने पर, आपको रोडमैप टाइल मिलती हैं. उदाहरण के लिए, यहां दिखाया गया है.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

इस एचटीटीपीएस जीईटी अनुरोध में, z ज़ूम लेवल है, जो 0 से 22 के बीच होता है. साथ ही, x और y, उस टाइल के टाइल कोऑर्डिनेट हैं जिसे आपको वापस पाना है.

ध्यान दें: टाइल कोऑर्डिनेट और भौगोलिक कोऑर्डिनेट एक जैसे नहीं होते. टाइल निर्देशांक के बारे में ज़्यादा जानकारी के लिए, Maps JavaScript API के दस्तावेज़ में मैप और टाइल निर्देशांक देखें.

orientation पैरामीटर का इस्तेमाल करना ज़रूरी नहीं है. इसकी वैल्यू से पता चलता है कि टाइल इमेज को, घड़ी की सुई के उलट दिशा में कितने डिग्री घुमाया गया है. orientation का इस्तेमाल, roadmap टाइल के लिए किया जा सकता है. साथ ही, सैटलाइट और इलाके की जानकारी के अनुरोधों के लिए भी इसका इस्तेमाल किया जा सकता है. हालांकि, इसके लिए "overlay": true का इस्तेमाल करके, बुनियादी इमेज हटानी होगी और layerTypes सेट करना होगा. orientation की मान्य वैल्यू 0 (डिफ़ॉल्ट), 90, 180, और 270 हैं.

orientation वैल्यू शामिल करने पर, टाइल के कोऑर्डिनेट ग्रिड को घुमाया नहीं जाता. उदाहरण के लिए, अगर orientation को 90 पर सेट किया जाता है, तो x कोऑर्डिनेट अब भी टाइल की बाईं से दाईं ओर की स्थिति तय करता है. इस मामले में, यह मैप पर उत्तर से दक्षिण की ओर है.

ज़ीरो-डिग्री ओरिएंटेशन	90 डिग्री ओरिएंटेशन

टाइल के अनुरोध का उदाहरण

यहां दिए गए उदाहरण में, पूरी दुनिया की जानकारी वाली एक टाइल का अनुरोध किया गया है. इस उदाहरण में, ज़ूम लेवल 0 है और x और y निर्देशांक 0, 0 हैं.

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

इस उदाहरण में, सर्वर से कोई जवाब मैसेज नहीं है. इसके बजाय, टाइल को लोकल फ़ाइल में डाउनलोड किया जाता है. इसमें ये आंकड़े होते हैं.

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

जवाब वाले मैसेज के हेडर के बारे में जानकारी पाने के लिए, कॉन्टेंट को पहले से फ़ेच करना, कैश मेमोरी में सेव करना या स्टोर करना लेख पढ़ें.