- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- SearchDestinationsRequest.AddressQuery
- SearchDestinationsRequest.LocationQuery
- SearchDestinationsRequest.LocationQuery.PlaceFilter
- PlaceView.StructureType
- SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
- NavigationPoint.TravelMode
- डेस्टिनेशन
- PlaceView
- लैंडमार्क
- Landmark.Tag
- एंट्रेंस
- Entrance.Tag
- StreetViewThumbnail
- ImageAnnotation
- ImageAnnotation.Coordinate
- NavigationPoint
- NavigationPoint.Usage
- Destination.ParkingOptions
- Destination.ParkingOptions.Availability
- Destination.ArrivalSummary
यह तरीका, डेस्टिनेशन लुकअप करता है और डेस्टिनेशन की सूची दिखाता है.
एचटीटीपी अनुरोध
POST https://geocode.googleapis.com/v4alpha/geocode/destinations
यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:
| JSON के काेड में दिखाना |
|---|
{ "travelModes": [ enum ( |
| फ़ील्ड | |
|---|---|
travelModes[] |
ज़रूरी नहीं. नेविगेशन पॉइंट को फ़िल्टर करने के लिए यात्रा के मोड. इससे, जवाब में मिले |
languageCode |
ज़रूरी नहीं. वह भाषा जिसमें नतीजे दिखाए जाने चाहिए. |
regionCode |
ज़रूरी नहीं. क्षेत्र का कोड. क्षेत्र का कोड, जिसे ccTLD ("टॉप-लेवल डोमेन") के तौर पर दो वर्णों वाली वैल्यू के तौर पर तय किया जाता है. यह पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डालता है. इस पैरामीटर से, सेवा के नतीजों पर भी असर पड़ता है. हालांकि, इससे सेवा के नतीजों को पूरी तरह से प्रतिबंधित नहीं किया जाता. |
यूनियन फ़ील्ड ये डेस्टिनेशन, दी गई मुख्य क्वेरी के आधार पर बनाए जाते हैं. ध्यान दें: सिर्फ़ उन जगहों और पतों के लिए नेविगेशन की सुविधा काम करती है जहां पहुंचा जा सकता है. उदाहरण के लिए, किसी घर या अपार्टमेंट कॉम्प्लेक्स को दिखाने वाली जगह को मुख्य क्वेरी के तौर पर इस्तेमाल किया जा सकता है. हालांकि, किसी इलाके या प्रशासनिक क्षेत्र को दिखाने वाली जगहों को मुख्य क्वेरी के तौर पर इस्तेमाल नहीं किया जा सकता. |
|
place |
जगह का संसाधन नाम, |
addressQuery |
मोहल्ले का पता. |
locationQuery |
जगह की सटीक जानकारी. |
जवाब का मुख्य भाग
DestinationService.SearchDestinations के लिए जवाब का मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
| JSON फ़ॉर्मैट में दिखाया गया है |
|---|
{
"destinations": [
{
object ( |
| फ़ील्ड | |
|---|---|
destinations[] |
डेस्टिनेशन की सूची. अगर मुख्य क्वेरी से मुख्य डेस्टिनेशन की पहचान साफ़ तौर पर की जा सकती है, तो सेवा एक नतीजा दिखाती है. ऐसा न करने पर, सेवा एक से ज़्यादा नतीजे दिखा सकती है या कोई भी नतीजा नहीं दिखा सकती है. |
अनुमति पाने के लिंक
इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/maps-platform.geocodehttps://www.googleapis.com/auth/maps-platform.destinations
SearchDestinationsRequest.AddressQuery
वह पता जिसे आपको खोजना है. पते, उस देश की राष्ट्रीय डाक सेवा के इस्तेमाल किए गए फ़ॉर्मैट के मुताबिक होने चाहिए.
| JSON के काेड में दिखाना |
|---|
{ // Union field |
| फ़ील्ड | |
|---|---|
यूनियन फ़ील्ड kind. पते के बारे में क्वेरी. kind इनमें से सिर्फ़ एक हो सकता है: |
|
address |
डाक पते के फ़ॉर्मैट में मोहल्ले का पता. |
addressQuery |
मोहल्ले का पता, जिसे एक लाइन में फ़ॉर्मैट किया गया हो. |
SearchDestinationsRequest.LocationQuery
आस-पास की मुख्य जगह की पहचान करने के लिए, जगह की जानकारी से जुड़ी क्वेरी.
ध्यान दें: अगर जगह की क्वेरी किसी ऐसी इमारत के लिए है जिसमें सबपरिसर शामिल हैं, तो हो सकता है कि जवाब में मिला मुख्य स्थान, सबपरिसर हो. ऐसे मामलों में, containingPlaces फ़ील्ड में इमारत की जानकारी शामिल होगी.
| JSON के काेड में दिखाना |
|---|
{ "placeFilter": { object ( |
| फ़ील्ड | |
|---|---|
placeFilter |
ज़रूरी नहीं. डेस्टिनेशन के तौर पर चुने गए उम्मीदवारों पर लागू किए जाने वाले फ़िल्टर. |
यूनियन फ़ील्ड kind. जगह की जानकारी के लिए क्वेरी. kind इनमें से सिर्फ़ एक हो सकता है: |
|
location |
जगह की सटीक LatLng जानकारी. |
SearchDestinationsRequest.LocationQuery.PlaceFilter
डेस्टिनेशन के तौर पर चुने गए उम्मीदवारों पर लागू किए जाने वाले फ़िल्टर.
| JSON के काेड में दिखाना |
|---|
{ "structureType": enum ( |
| फ़ील्ड | |
|---|---|
structureType |
ज़रूरी नहीं. अगर यह जानकारी दी गई है, तो सभी डेस्टिनेशन में इस स्ट्रक्चर टाइप का प्राइमरी प्लेस होना ज़रूरी है. इस वजह से, कुछ डेस्टिनेशन को फ़िल्टर किया जा सकता है या दिखाए गए डेस्टिनेशन को बेहतर बनाया जा सकता है. उदाहरण के लिए, अगर इस फ़ील्ड का इस्तेमाल, बिल्डिंग के डिसप्ले पॉलीगॉन को आसानी से निकालने के लिए भी किया जा सकता है. उदाहरण के लिए, अगर |
addressability |
ज़रूरी नहीं. अगर यह विकल्प चुना जाता है, तो सिर्फ़ उन डेस्टिनेशन को दिखाता है जो पते के हिसाब से टारगेटिंग करने की ज़रूरी शर्तें पूरी करते हैं. |
PlaceView.StructureType
यह जगह किस तरह की है.
| Enums | |
|---|---|
STRUCTURE_TYPE_UNSPECIFIED |
इस्तेमाल नहीं किया जाता. |
POINT |
पॉइंट लोकेशन. |
SECTION |
किसी बिल्डिंग का सब-सेक्शन. |
BUILDING |
एक बिल्डिंग. |
GROUNDS |
यह एक बड़ा इलाका होता है, जिसमें आम तौर पर कई इमारतें होती हैं. जैसे, यूनिवर्सिटी कैंपस, अपार्टमेंट कॉम्प्लेक्स या शॉपिंग मॉल. |
SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
यह कुकी, टारगेटिंग के लिए उपलब्ध ऑडियंस को फ़िल्टर करने के विकल्पों के बारे में बताती है. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं.
| Enums | |
|---|---|
ADDRESSABILITY_UNSPECIFIED |
अगर कोई वैल्यू नहीं दी जाती है, तो सेवा डिफ़ॉल्ट रूप से कोई सही वैल्यू चुन लेगी. |
ANY |
विज्ञापन दिखाने के लिए सही ऑडियंस को टारगेट करना, फ़िल्टर करने की शर्त नहीं है. डेस्टिनेशन, उनकी पहुंच के हिसाब से दिखाए जाते हैं. |
PRIMARY |
जवाब में मिले सभी डेस्टिनेशन में, सड़क के लेवल का पता या नाम वाली मुख्य जगह होगी. |
WEAK |
जवाब में मिले सभी डेस्टिनेशन में, सड़क के लेवल का पता या नाम वाला कोई मुख्य स्थान या सबडेस्टिनेशन होगा. |
मंज़िल
डेस्टिनेशन. इसमें मुख्य जगह, उससे जुड़ी जगहें, प्रवेश द्वार, और नेविगेशन पॉइंट शामिल हैं.
| JSON के काेड में दिखाना |
|---|
{ "primary": { object ( |
| फ़ील्ड | |
|---|---|
primary |
अनुरोध में |
containingPlaces[] |
वे जगहें जो मुख्य जगह के मुकाबले कम सटीक हैं. उदाहरण के लिए, अपार्टमेंट कॉम्प्लेक्स, जिसमें यह बिल्डिंग मौजूद है. |
subDestinations[] |
मुख्य जगह के ज़्यादा सटीक उप-डेस्टिनेशन. उदाहरण के लिए, किसी बिल्डिंग में मौजूद यूनिट. ध्यान दें: Places API से मिले SubDestination की तुलना में, सब-डेस्टिनेशन की यह सूची ज़्यादा जानकारी वाली होती है. साथ ही, हर सब-डेस्टिनेशन में ज़्यादा जानकारी होती है. |
landmarks[] |
लैंडमार्क, जिनका इस्तेमाल यह बताने के लिए किया जा सकता है कि डेस्टिनेशन कहां है या पहुंचने में मदद मिल सकती है. |
entrances[] |
इस डेस्टिनेशन के लिए प्रवेश द्वार. |
navigationPoints[] |
इस डेस्टिनेशन के लिए नेविगेशन पॉइंट. |
parkingOptions |
इस जगह के लिए पार्किंग के विकल्प. |
arrivalSummary |
मंज़िल पर पहुंचने के अनुभव के बारे में, एआई से जनरेट की गई खास जानकारी. |
PlaceView
Places API में, जगह के व्यू को दिखाता है. यह डेस्टिनेशन के बारे में ज़्यादा जानकारी भी देता है. जैसे, स्ट्रक्चर का टाइप और डिसप्ले पॉलीगॉन.
कुछ मामलों में, एक ही जगह के आईडी वाले PlaceView की वैल्यू, types और displayName फ़ील्ड के लिए Places API से मिली वैल्यू से अलग हो सकती है.
| JSON के काेड में दिखाना |
|---|
{ "place": string, "displayName": { object ( |
| फ़ील्ड | |
|---|---|
place |
इस जगह का संसाधन नाम, |
placeId |
किसी जगह का यूनीक आइडेंटिफ़ायर. |
displayName |
जगह के बारे में ऐसी जानकारी जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण के लिए, "गेट बी", "मैकडॉनल्ड्स" |
primaryType |
इस जगह का मुख्य टाइप. संभावित वैल्यू की सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाएं. ध्यान दें: इस फ़ील्ड में हमेशा जानकारी नहीं भरी जाती. ऐसे मामलों में, |
types[] |
इस जगह से जुड़ी सभी तरह की जगहें. संभावित वैल्यू की सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाएं. |
formattedAddress |
एक लाइन का पता. |
postalAddress |
स्ट्रक्चर्ड पता. |
structureType |
इस जगह से जुड़ा स्ट्रक्चर किस तरह का है. |
location |
इस जगह की लोकेशन. जिन जगहों के लिए डिसप्ले पॉलीगॉन मौजूद हैं उनके लिए, यह मैप पर मार्कर लगाने की अच्छी जगह हो सकती है. |
displayPolygon |
जगह की पॉलीगॉन आउटलाइन, RFC 7946 फ़ॉर्मैट का इस्तेमाल करके GeoJSON फ़ॉर्मैट में: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6. ध्यान दें: आरएफ़सी 7946 फ़ॉर्मैट में मल्टीपॉलीगॉन काम करते हैं. इसलिए, एक |
लैंडमार्क
लैंडमार्क का इस्तेमाल यह बताने के लिए किया जाता है कि मंज़िल कहाँ है या मंज़िल तक पहुँचने में मदद करने के लिए किया जाता है.
| JSON के काेड में दिखाना |
|---|
{ "relationalDescription": { object ( |
| फ़ील्ड | |
|---|---|
relationalDescription |
इस स्ट्रिंग में, डेस्टिनेशन और लैंडमार्क के बीच के संबंध के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण के लिए: "एम्पायर स्टेट बिल्डिंग के पास" या "संसद भवन के सामने". |
tags[] |
ऐसे टैग जिनसे पता चलता है कि मंज़िल के हिसाब से लैंडमार्क का इस्तेमाल कैसे किया जा सकता है. |
straightLineDistanceMeters |
सिर्फ़ आउटपुट के लिए. इस लैंडमार्क से डेस्टिनेशन तक की सीधी दूरी, मीटर में. |
travelDistanceMeters |
सिर्फ़ आउटपुट के लिए. इस लैंडमार्क से डेस्टिनेशन तक सड़क के नेटवर्क की दूरी, मीटर में. |
यूनियन फ़ील्ड landmark. लैंडमार्क. landmark इनमें से सिर्फ़ एक हो सकता है: |
|
place |
वह जगह जो इस लैंडमार्क को दिखाती है. |
Landmark.Tag
उन सभी टैग की सूची जो यह बताते हैं कि किसी जगह के संदर्भ में लैंडमार्क का इस्तेमाल कैसे किया जा सकता है.
अगर किसी पते में ADDRESS और ARRIVAL दोनों टैग मौजूद हैं, तो इसका मतलब है कि लैंडमार्क, स्थानीय तौर पर लोकप्रिय है और डेस्टिनेशन के पास है.
| Enums | |
|---|---|
TAG_UNSPECIFIED |
इस्तेमाल नहीं किया जाता. |
ADDRESS |
स्थानीय तौर पर मशहूर जगह. इसका इस्तेमाल, मंज़िल की सामान्य जगह की पहचान करने के लिए किया जा सकता है. आम तौर पर, यह जगह मंज़िल से कुछ सौ मीटर के दायरे में होती है. ये, Geocoding API की Address Descriptors सुविधा से मिले लैंडमार्क की तरह होते हैं: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors. |
ARRIVAL |
ऐसी जगह जिसका इस्तेमाल मंज़िल तक पहुंचने में मदद करने के लिए किया जा सकता है. मंज़िल के आस-पास पहुंचने पर, नेविगेशन के लिए यह कुकी काम की होती है. उदाहरण के लिए, यह लैंडमार्क ऐसी जगह हो सकती है जो मंज़िल के ठीक सामने वाली सड़क पर हो. इस टैग वाली जगह, आम तौर पर ADDRESS टैग वाली जगहों की तुलना में डेस्टिनेशन के ज़्यादा करीब होती है. |
प्रवेश
प्रवेश द्वार, अक्षांश/देशांतर के निर्देशांक का एक ऐसा जोड़ा होता है जो किसी जगह के एंट्री और एक्ज़िट पॉइंट की जगह की जानकारी देता है.
| JSON के काेड में दिखाना |
|---|
{ "location": { object ( |
| फ़ील्ड | |
|---|---|
location |
प्रवेश द्वार की जगह. |
tags[] |
प्रवेश द्वार की जानकारी देने वाले टैग की सूची. |
place |
दरवाज़े पर लगाई गई पिन, जिस इमारत पर मौजूद है उसकी जानकारी |
streetViewThumbnail |
स्ट्रीट व्यू की थंबनेल इमेज, जिसमें अंदर जाने का रास्ता दिखता है. इस इमेज का अनुरोध, Street View Static API से किया जा सकता है. https://developers.google.com/maps/documentation/streetview/request-streetview पर जाएं. |
streetViewAnnotation |
ऊपर दिखाए गए |
Entrance.Tag
किसी एंट्री के बारे में बताने वाली विशेषताएं.
| Enums | |
|---|---|
TAG_UNSPECIFIED |
इस्तेमाल नहीं किया जाता. |
PREFERRED |
इस बात की संभावना है कि मुख्य सड़क से अंदर जाने का रास्ता, खोज के नतीजों में दिखाए गए मुख्य स्थान तक पहुंचने का रास्ता हो. किसी जगह के लिए, एक से ज़्यादा पसंदीदा रास्ते हो सकते हैं. अगर किसी प्रवेश द्वार पर यह टैग नहीं है, तो इसका मतलब है कि प्रवेश द्वार, मुख्य जगह वाली बिल्डिंग में ही है. हालांकि, यह ज़रूरी नहीं है कि इससे उस जगह तक पहुंचा जा सके. उदाहरण के लिए, अगर मुख्य जगह स्ट्रिप मॉल में मौजूद कोई रेस्टोरेंट है, तो "PREFERRED" एंट्री वे होंगी जो सीधे रेस्टोरेंट में जाती हैं. वहीं, अन्य एंट्री वे होंगी जो बिल्डिंग में मौजूद अन्य रेस्टोरेंट में जाती हैं. अगर मुख्य जगह कोई बिल्डिंग है, तो ध्यान दें: ऐसा हो सकता है कि |
StreetViewThumbnail
Google Street View के थंबनेल को दिखाने के लिए पैरामीटर. इन पैरामीटर का इस्तेमाल, Street View Static API से Street View इमेज का अनुरोध करने के लिए किया जा सकता है. https://developers.google.com/maps/documentation/streetview/request-streetview पर जाएं.
| JSON के काेड में दिखाना |
|---|
{ "pano": string, "widthPx": integer, "heightPx": integer, "headingDegree": number, "pitchDegree": number, "fovDegree": number } |
| फ़ील्ड | |
|---|---|
pano |
कोई पैनोरामा आईडी. |
widthPx |
आउटपुट थंबनेल इमेज की चौड़ाई, पिक्सल में. ध्यान दें: थंबनेल के साथ एनोटेशन का अनुरोध करते समय, ऊंचाई और चौड़ाई की इन वैल्यू का इस्तेमाल Street View API के अनुरोध में किया जाना चाहिए. इससे यह पक्का किया जा सकेगा कि एनोटेशन के कोऑर्डिनेट, इमेज के साथ सही तरीके से अलाइन हों. |
heightPx |
आउटपुट थंबनेल इमेज की ऊंचाई, पिक्सल में. ध्यान दें: थंबनेल के साथ एनोटेशन का अनुरोध करते समय, ऊंचाई और चौड़ाई की इन वैल्यू का इस्तेमाल Street View API के अनुरोध में किया जाना चाहिए. इससे यह पक्का किया जा सकेगा कि एनोटेशन के कोऑर्डिनेट, इमेज के साथ सही तरीके से अलाइन हों. |
headingDegree |
डिग्री में, कैमरे का हॉरिज़ॉन्टल ओरिएंटेशन. रेंज [0, 360). 0 उत्तर है और 90 पूर्व है. |
pitchDegree |
डिग्री में, कैमरे का वर्टिकल ओरिएंटेशन. रेंज [-90, 90]. 0 डिग्री का मतलब है कि कैमरा हॉरिज़ॉन्टल है, +90 डिग्री का मतलब है कि कैमरा ऊपर की ओर है, और -90 डिग्री का मतलब है कि कैमरा नीचे की ओर है. |
fovDegree |
डिग्री में हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू. रेंज (0, 180]. इससे ज़ूम लेवल को कंट्रोल किया जाता है. एफ़ओवी जितना कम होगा, ज़ूम उतना ही ज़्यादा होगा. |
ImageAnnotation
किसी इमेज थंबनेल पर एनोटेशन, जैसे कि किसी प्रवेश द्वार को हाइलाइट करने वाला पॉलीगॉन.
| JSON के काेड में दिखाना |
|---|
{
"coordinates": [
{
object ( |
| फ़ील्ड | |
|---|---|
coordinates[] |
यह इमेज पर पॉलीगॉन बनाने वाले कोऑर्डिनेट की सूची होती है. निर्देशांकों को घड़ी की उल्टी दिशा में क्रम से लगाया जाता है. |
ImageAnnotation.Coordinate
इमेज पर मौजूद किसी पॉइंट का पिक्सल कोऑर्डिनेट. ऑरिजिन (0,0) इमेज के सबसे ऊपर बाएं कोने वाले पिक्सल का सबसे ऊपर बायां कोना होता है. इसमें x-ऐक्सिस दाईं ओर और y-ऐक्सिस नीचे की ओर होता है.
| JSON के काेड में दिखाना |
|---|
{ "xPx": number, "yPx": number } |
| फ़ील्ड | |
|---|---|
xPx |
X कॉर्डिनेट. |
yPx |
Y कॉर्डिनेट. |
Destination.ParkingOptions
मंज़िल पर पार्किंग के विकल्पों के बारे में जानकारी.
| JSON के काेड में दिखाना |
|---|
{
"availability": enum ( |
| फ़ील्ड | |
|---|---|
availability |
इस जगह पर पार्किंग की सुविधा उपलब्ध है या नहीं. |
onsiteParking |
मंज़िल पर, ऑनसाइट पार्किंग की सुविधा उपलब्ध है. |
freeParkingLot |
मुफ़्त पार्किंग की सुविधा देता हो. |
paidParkingLot |
पैसे चुकाकर पार्किंग की सुविधा देता हो. |
freeStreetParking |
सड़क के किनारे मुफ़्त पार्किंग की सुविधा है. |
paidStreetParking |
सड़क के किनारे पार्किंग की सुविधा के लिए पैसे देने होंगे. |
valetParking |
वैले पार्किंग की सुविधा देता हो. |
freeGarageParking |
गैराज में मुफ़्त पार्किंग की सुविधा देता है. |
paidGarageParking |
पैसे चुकाकर गराज में पार्किंग करने की सुविधा है. |
Destination.ParkingOptions.Availability
इस जगह पर आने वाले लोगों के लिए, पार्किंग की जगह ढूंढना कितना मुश्किल है, यह दिखाने वाला एग्रीगेटेड मेज़रमेंट.
आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं.
| Enums | |
|---|---|
AVAILABILITY_UNSPECIFIED |
पार्किंग की उपलब्धता की जानकारी उपलब्ध नहीं है. |
PLENTY |
यहां पार्किंग के लिए काफ़ी जगह उपलब्ध है. |
SOMEWHAT_DIFFICULT |
यहां पार्किंग की जगह मिलना कुछ हद तक मुश्किल है. |
DIFFICULT |
पार्किंग की जगह मिलना बहुत मुश्किल है. |
Destination.ArrivalSummary
मंज़िल पर पहुंचने के अनुभव के बारे में, एआई से जनरेट की गई खास जानकारी.
| JSON के काेड में दिखाना |
|---|
{ "text": { object ( |
| फ़ील्ड | |
|---|---|
text |
डेस्टिनेशन पर पहुंचने के अनुभव के बारे में खास जानकारी. |
flagContentUrl |
एक लिंक, जहां उपयोगकर्ता जवाब में मौजूद किसी समस्या के बारे में शिकायत कर सकते हैं. |
disclosureText |
सिर्फ़ आउटपुट के लिए. इसमें यात्रा के बारे में जानकारी देने वाले टेक्स्ट की जानकारी होती है. |