रोडमैप टाइल

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

रोडमैप टाइल, वेक्टर टॉपोग्राफ़िक डेटा पर आधारित इमेज टाइल होती हैं. इनमें 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, उस टाइल के टाइल कोऑर्डिनेट हैं जिसे आपको वापस पाना है.

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

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