- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- MapType
- इसे आज़माएं!
एक बाइट अरे दिखाता है, जिसमें टाइल PNG इमेज का डेटा होता है.
एचटीटीपी अनुरोध
GET https://pollen.googleapis.com/v1/mapTypes/{mapType}/heatmapTiles/{zoom}/{x}/{y}
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
mapType |
ज़रूरी है. पराग हीटमैप का प्रकार. यह बताता है कि मैप पर किस तरह के पराग कण और इंडेक्स को ग्राफ़िक के तौर पर दिखाया जाएगा. |
zoom |
ज़रूरी है. मैप का ज़ूम लेवल. तय करता है कि मैप व्यू में मैप का कॉन्टेंट कितना बड़ा या छोटा दिखेगा.
मंज़ूर किए गए मान: 0-16 |
x |
ज़रूरी है. अनुरोध की गई टाइल में पूर्व-पश्चिम बिंदु के बारे में बताता है. |
y |
ज़रूरी है. अनुरोध की गई टाइल में उत्तर-दक्षिण बिंदु के बारे में बताता है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
यह मैसेज एक आर्बिट्ररी एचटीटीपी काेड दिखाता है. इसका इस्तेमाल सिर्फ़ पेलोड फ़ॉर्मैट के लिए किया जाना चाहिए, जिसे मूल बाइनरी या एचटीएमएल पेज जैसे जेएसओएन के रूप में नहीं दिखाया जा सकता.
इस मैसेज का इस्तेमाल अनुरोध और जवाब में एपीआई के स्ट्रीमिंग और बिना स्ट्रीमिंग वाले दाेनाें तरीकों में किया जा सकता है.
इसका इस्तेमाल टॉप-लेवल के अनुरोध फ़ील्ड के रूप में किया जा सकता है. अगर कोई व्यक्ति यूआरएल या एचटीटीपी टेम्प्लेट से पैरामीटर को अनुरोध फ़ील्ड में लाना और मूल एचटीटीपी के मुख्य भाग का इस्तेमाल करना चाहता है, ताे इसके लिए भी यह अच्छा विकल्प है.
उदाहरण:
message GetResourceRequest {
// A unique request id.
string request_id = 1;
// The raw HTTP body is bound to this field.
google.api.HttpBody http_body = 2;
}
service ResourceService {
rpc GetResource(GetResourceRequest)
returns (google.api.HttpBody);
rpc UpdateResource(google.api.HttpBody)
returns (google.protobuf.Empty);
}
स्ट्रीमिंग के तरीकाें के साथ उदाहरण:
service CaldavService {
rpc GetCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
rpc UpdateCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
}
स्ट्रीमिंग के इस प्रकार का इस्तेमाल सिर्फ़ तब बदलता है जब अनुरोध और जवाब के मुख्य में बदलाव हाेता है. बाकी सभी सुविधाएं वैसे ही काम करती हैं.
अगर सही तरीके से रिस्पॉन्स दिया जाता है, तो यह एक सामान्य एचटीटीपी रिस्पॉन्स होता है. इसका फ़ॉर्मैट, तरीके से तय होता है.
JSON के काेड में दिखाना |
---|
{ "contentType": string, "data": string, "extensions": [ { "@type": string, field1: ..., ... } ] } |
फ़ील्ड | |
---|---|
contentType |
एचटीटीपी कॉन्टेंट टाइप हेडर वैल्यू, जो मुख्य भाग के कॉन्टेंट टाइप के बारे में बताती है. |
data |
रॉ बाइनरी के तौर पर एचटीटीपी अनुरोध/जवाब का मुख्य हिस्सा. base64 कोड में बदली गई स्ट्रिंग. |
extensions[] |
ऐप्लिकेशन के जवाब का खास मेटाडेटा. स्ट्रीमिंग एपीआई के लिए पहले जवाब में सेट किया जाना चाहिए. ऐसा ऑब्जेक्ट जिसमें आर्बिट्रेरी टाइप के फ़ील्ड शामिल होते हैं. अतिरिक्त फ़ील्ड |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
MapType
पराग हीटमैप का प्रकार. यह बताता है कि मैप पर किस तरह के पराग कण और इंडेक्स को ग्राफ़िक के तौर पर दिखाया जाएगा.
Enums | |
---|---|
MAP_TYPE_UNSPECIFIED |
मैप किस तरह का है, इसकी जानकारी नहीं है. |
TREE_UPI |
हीटमैप टाइप, ट्री इंडेक्स वाले ग्राफ़िकल मैप को दिखाएगा. |
GRASS_UPI |
हीटमैप का टाइप, ग्रास इंडेक्स ग्राफ़िकल मैप को दिखाएगा. |
WEED_UPI |
हीटमैप टाइप, वीड इंडेक्स वाले ग्राफ़िकल मैप को दिखाएगा. |