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