Method: geocode.destinations.searchDestinations

यह तरीका, डेस्टिनेशन की खोज करता है और डेस्टिनेशन की सूची दिखाता है.

एचटीटीपी अनुरोध

POST https://geocode.googleapis.com/v4alpha/geocode/destinations

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "travelModes": [
    enum (NavigationPoint.TravelMode)
  ],
  "languageCode": string,
  "regionCode": string,

  // Union field primary_query can be only one of the following:
  "place": string,
  "addressQuery": {
    object (SearchDestinationsRequest.AddressQuery)
  },
  "locationQuery": {
    object (SearchDestinationsRequest.LocationQuery)
  }
  // End of list of possible types for union field primary_query.
}
फ़ील्ड
travelModes[]

enum (NavigationPoint.TravelMode)

ज़रूरी नहीं. यात्रा के वे मोड जिनके लिए नेविगेशन पॉइंट फ़िल्टर करने हैं. इससे, जवाब में मिलने वाले navigationPoints फ़ील्ड पर असर पड़ता है. अगर यह फ़ील्ड खाली है, तो यात्रा के सभी मोड के नेविगेशन पॉइंट दिखाए जाते हैं.

languageCode

string

ज़रूरी नहीं. वह भाषा जिसमें नतीजे दिखाए जाने चाहिए.

regionCode

string

ज़रूरी नहीं. देश/इलाके का कोड. क्षेत्र का कोड, जिसे ccTLD ("टॉप-लेवल डोमेन") के तौर पर दो वर्णों वाली वैल्यू के तौर पर तय किया जाता है. यह पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डालता है. यह पैरामीटर, सेवा से मिलने वाले नतीजों पर भी असर डालता है. हालांकि, यह नतीजों को पूरी तरह से सीमित नहीं करता.

यूनियन फ़ील्ड primary_query. प्राइमरी डेस्टिनेशन के लिए क्वेरी. यह कोई जगह, पूरा पता या अक्षांश और देशांतर की जानकारी हो सकती है. जिन जगहों और पतों की जानकारी बहुत कम है उन्हें डेस्टिनेशन में नहीं बदला जा सकेगा.

डेस्टिनेशन, बताई गई प्राथमिक क्वेरी के हिसाब से बनाए जाते हैं.

ध्यान दें: सिर्फ़ ऐसी जगहों और पतों की जानकारी दी जा सकती है जिन पर नेविगेट किया जा सकता है. उदाहरण के लिए, किसी घर या अपार्टमेंट कॉम्प्लेक्स की जानकारी देने वाली जगह को मुख्य क्वेरी के तौर पर इस्तेमाल किया जा सकता है. हालांकि, किसी इलाके या प्रशासनिक क्षेत्र की जानकारी देने वाली जगहों को मुख्य क्वेरी के तौर पर इस्तेमाल नहीं किया जा सकता. primary_query इनमें से सिर्फ़ एक हो सकता है:

place

string

किसी जगह का संसाधन नाम, places/{placeId} फ़ॉर्मैट में.

addressQuery

object (SearchDestinationsRequest.AddressQuery)

मोहल्ले का पता.

locationQuery

object (SearchDestinationsRequest.LocationQuery)

जगह की सटीक जानकारी.

जवाब का मुख्य भाग

DestinationService.SearchDestinations के लिए जवाब का मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है
{
  "destinations": [
    {
      object (Destination)
    }
  ]
}
फ़ील्ड
destinations[]

object (Destination)

डेस्टिनेशन की सूची.

अगर मुख्य क्वेरी से मुख्य डेस्टिनेशन की पहचान साफ़ तौर पर की जा सकती है, तो सेवा एक नतीजा दिखाती है. ऐसा न करने पर, सेवा एक से ज़्यादा नतीजे दिखा सकती है या कोई भी नतीजा नहीं दिखा सकती है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.destinations

SearchDestinationsRequest.AddressQuery

मोहल्ले का वह पता जिसे आपको खोजना है. पते, उस देश की राष्ट्रीय डाक सेवा के फ़ॉर्मैट के मुताबिक डालें.

JSON के काेड में दिखाना
{

  // Union field kind can be only one of the following:
  "address": {
    object (PostalAddress)
  },
  "addressQuery": string
  // End of list of possible types for union field kind.
}
फ़ील्ड
यूनियन फ़ील्ड kind. पते के बारे में क्वेरी. kind इनमें से सिर्फ़ एक हो सकता है:
address

object (PostalAddress)

डाक पते के फ़ॉर्मैट में गली का पता.

addressQuery

string

मोहल्ले का पता, जिसे एक लाइन में फ़ॉर्मैट किया गया है.

SearchDestinationsRequest.LocationQuery

आस-पास की मुख्य जगह की पहचान करने के लिए, जगह की जानकारी वाली क्वेरी.

ध्यान दें: अगर जगह की जानकारी के लिए की गई क्वेरी, किसी ऐसी इमारत के अंदर की है जिसमें सबप्रीमाइसेस शामिल हैं, तो हो सकता है कि जवाब में मिला मुख्य स्थान, सबप्रीमाइसेस हो. ऐसे मामलों में, containingPlaces फ़ील्ड में इमारत की जानकारी शामिल होगी.

JSON के काेड में दिखाना
{
  "placeFilter": {
    object (SearchDestinationsRequest.LocationQuery.PlaceFilter)
  },

  // Union field kind can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field kind.
}
फ़ील्ड
placeFilter

object (SearchDestinationsRequest.LocationQuery.PlaceFilter)

ज़रूरी नहीं. डेस्टिनेशन कैंडिडेट पर लागू किए जाने वाले फ़िल्टर.

यूनियन फ़ील्ड kind. जगह की जानकारी वाली क्वेरी. kind इनमें से सिर्फ़ एक हो सकता है:
location

object (LatLng)

जगह की सटीक जानकारी देने वाला LatLng.

SearchDestinationsRequest.LocationQuery.PlaceFilter

डेस्टिनेशन कैंडिडेट पर लागू किए जाने वाले फ़िल्टर.

JSON के काेड में दिखाना
{
  "structureType": enum (PlaceView.StructureType),
  "addressability": enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)
}
फ़ील्ड
structureType

enum (PlaceView.StructureType)

ज़रूरी नहीं. अगर इसकी जानकारी दी जाती है, तो यह गारंटी दी जाती है कि सभी डेस्टिनेशन में इस स्ट्रक्चर टाइप वाली मुख्य जगह मौजूद होगी. इस वजह से, कुछ डेस्टिनेशन फ़िल्टर हो सकते हैं या दिखाए गए डेस्टिनेशन को बेहतर बनाया जा सकता है.

उदाहरण के लिए, अगर GROUNDS तय किया गया है, तो दिखाए गए सभी डेस्टिनेशन में GROUNDS स्ट्रक्चर टाइप वाली मुख्य जगह होगी. इस वजह से, हो सकता है कि कुछ ऐसे डेस्टिनेशन फ़िल्टर हो जाएं जो किसी ग्राउंड का हिस्सा नहीं हैं. इसके अलावा, यह भी हो सकता है कि लौटाए गए डेस्टिनेशन को ग्राउंड लेवल पर ले जाया जाए.

इस फ़ील्ड का इस्तेमाल, बिल्डिंग के डिसप्ले पॉलीगॉन को आसानी से निकालने के लिए भी किया जा सकता है. उदाहरण के लिए, अगर BUILDING की जानकारी दी गई है, तो मुख्य जगह के तौर पर बताई गई जगह पर मौजूद बिल्डिंग के लिए, डिसप्ले पॉलीगॉन दिखेगा.

addressability

enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)

ज़रूरी नहीं. अगर यह विकल्प चुना जाता है, तो सिर्फ़ उन डेस्टिनेशन की जानकारी मिलती है जो पते के हिसाब से टारगेटिंग की शर्तों को पूरा करते हैं.

PlaceView.StructureType

यह जगह किस तरह की है.

Enums
STRUCTURE_TYPE_UNSPECIFIED इस्तेमाल नहीं किया गया.
POINT जगह की जानकारी देने वाला पॉइंट.
SECTION किसी बिल्डिंग का सब-सेक्शन.
BUILDING एक इमारत.
GROUNDS एक बड़ा इलाका, जिसमें आम तौर पर कई इमारतें होती हैं. जैसे, यूनिवर्सिटी कैंपस, अपार्टमेंट कॉम्प्लेक्स या शॉपिंग मॉल.

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

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

Enums
ADDRESSABILITY_UNSPECIFIED अगर कोई वैल्यू नहीं दी जाती है, तो सेवा डिफ़ॉल्ट रूप से कोई सही वैल्यू चुन लेगी.
ANY ऐड्रेसेबिलिटी, फ़िल्टर करने की कोई शर्त नहीं है. डेस्टिनेशन की जानकारी, उनके पते की उपलब्धता के बावजूद दिखाई जाती है.
PRIMARY नतीजों में दिखाए गए सभी डेस्टिनेशन में, एक मुख्य जगह होगी. साथ ही, उसका नाम या सड़क के लेवल का पता होगा.
WEAK जवाब में मिले सभी डेस्टिनेशन में, सड़क के लेवल का पता या नाम वाला कोई मुख्य स्थान या सबडेस्टिनेशन होगा.

मंज़िल

कोई डेस्टिनेशन. इसमें मुख्य जगह, उससे जुड़ी जगहें, एंट्री पॉइंट, और नेविगेशन पॉइंट शामिल हैं.

JSON के काेड में दिखाना
{
  "primary": {
    object (PlaceView)
  },
  "containingPlaces": [
    {
      object (PlaceView)
    }
  ],
  "subDestinations": [
    {
      object (PlaceView)
    }
  ],
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ],
  "parkingOptions": {
    object (Destination.ParkingOptions)
  },
  "arrivalSummary": {
    object (Destination.ArrivalSummary)
  }
}
फ़ील्ड
primary

object (PlaceView)

अनुरोध में primary_query के ज़रिए बताई गई मुख्य जगह.

containingPlaces[]

object (PlaceView)

मुख्य जगह के आस-पास की कम सटीक जगहें. उदाहरण के लिए, वह अपार्टमेंट कॉम्प्लेक्स जिसमें यह इमारत मौजूद है.

subDestinations[]

object (PlaceView)

मुख्य जगह के आस-पास मौजूद अन्य जगहों की ज़्यादा सटीक जानकारी. उदाहरण के लिए, किसी बिल्डिंग में मौजूद यूनिट.

ध्यान दें: Places API से मिलने वाले SubDestination की तुलना में, सब-डेस्टिनेशन की यह सूची ज़्यादा बेहतर है. साथ ही, हर सब-डेस्टिनेशन में ज़्यादा जानकारी होती है.

landmarks[]

object (Landmark)

ऐसे लैंडमार्क जिनका इस्तेमाल यह बताने के लिए किया जा सकता है कि डेस्टिनेशन कहां है या पहुंचने में मदद मिल सकती है.

entrances[]

object (Entrance)

इस डेस्टिनेशन के लिए एंट्री पॉइंट.

navigationPoints[]

object (NavigationPoint)

इस डेस्टिनेशन के लिए नेविगेशन पॉइंट.

parkingOptions

object (Destination.ParkingOptions)

इस डेस्टिनेशन के लिए पार्किंग के विकल्प.

arrivalSummary

object (Destination.ArrivalSummary)

एआई से बनाया गया कॉन्टेंट, जिसमें मंज़िल पर पहुंचने के अनुभव के बारे में बताया गया है.

PlaceView

यह Places API में किसी जगह के व्यू को दिखाता है. यह डेस्टिनेशन के बारे में अतिरिक्त जानकारी भी देता है. जैसे, स्ट्रक्चर का टाइप और डिसप्ले पॉलीगॉन.

कुछ मामलों में, एक ही जगह के आईडी वाले PlaceView की जानकारी, Places API से types और displayName फ़ील्ड के लिए मिलने वाली जानकारी से अलग हो सकती है.

JSON के काेड में दिखाना
{
  "place": string,
  "displayName": {
    object (LocalizedText)
  },
  "primaryType": string,
  "types": [
    string
  ],
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "structureType": enum (PlaceView.StructureType),
  "location": {
    object (LatLng)
  },
  "displayPolygon": {
    object
  },
  "addressComponents": [
    {
      object (PlaceView.AddressComponent)
    }
  ]
}
फ़ील्ड
place

string

इस जगह के संसाधन का नाम, places/{placeId} फ़ॉर्मैट में. इस कुकी का इस्तेमाल, जगह की जानकारी देखने के लिए किया जा सकता है.

placeId

string

किसी जगह का यूनीक आइडेंटिफ़ायर.

displayName

object (LocalizedText)

जगह की जानकारी, जिसे कोई व्यक्ति आसानी से पढ़ सके. उदाहरण के लिए, "गेट बी", "मैकडॉनल्ड्स"

primaryType

string

यह जगह किस तरह की है. संभावित वैल्यू की सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाएं.

ध्यान दें: इस फ़ील्ड में हमेशा जानकारी नहीं भरी जाती. ऐसी स्थितियों में, types फ़ील्ड का इस्तेमाल करने के लिए तैयार रहें.

types[]

string

इस जगह से जुड़े सभी तरह के टाइप. संभावित वैल्यू की सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाएं.

formattedAddress

string

एक लाइन में पता.

postalAddress

object (PostalAddress)

स्ट्रक्चर्ड पता.

structureType

enum (PlaceView.StructureType)

इस जगह के स्ट्रक्चर का टाइप.

location

object (LatLng)

इस जगह की लोकेशन. पॉलीगॉन दिखाने वाली जगहों के लिए, यह मैप पर मार्कर लगाने के लिए एक अच्छी जगह हो सकती है.

displayPolygon

object (Struct format)

जगह की पॉलीगॉन आउटलाइन, GeoJSON फ़ॉर्मैट में. इसके लिए, RFC 7946 फ़ॉर्मैट का इस्तेमाल किया जाता है: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

ध्यान दें: आरएफ़सी 7946 फ़ॉर्मैट में मल्टीपॉलीगॉन काम करते हैं. इसलिए, एक displayPolygon ऑब्जेक्ट कई पॉलीगॉन को दिखा सकता है.

addressComponents[]

object (PlaceView.AddressComponent)

हर इलाके के लेवल के लिए दोहराए गए कॉम्पोनेंट.

PlaceView.AddressComponent

फ़ॉर्मैट किए गए पते को बनाने वाले स्ट्रक्चर्ड कॉम्पोनेंट. हालांकि, यह जानकारी सिर्फ़ तब उपलब्ध होती है, जब यह मौजूद हो.

JSON के काेड में दिखाना
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
फ़ील्ड
longText

string

पते के कॉम्पोनेंट का पूरा टेक्स्ट या नाम. उदाहरण के लिए, ऑस्ट्रेलिया देश के पते के कॉम्पोनेंट का नाम "ऑस्ट्रेलिया" हो सकता है.

shortText

string

पते के कॉम्पोनेंट का छोटा नाम, अगर उपलब्ध हो. उदाहरण के लिए, ऑस्ट्रेलिया के पते के कॉम्पोनेंट का छोटा नाम "AU" हो सकता है.

types[]

string

एक ऐरे, जो पते के कॉम्पोनेंट के टाइप के बारे में बताता है.

ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types पर जाएं.

languageCode

string

इस कॉम्पोनेंट को फ़ॉर्मैट करने के लिए इस्तेमाल की गई भाषा, सीएलडीआर नोटेशन में.

लैंडमार्क

लैंडमार्क का इस्तेमाल, यह बताने के लिए किया जाता है कि डेस्टिनेशन कहां है या डेस्टिनेशन तक पहुंचने में मदद करने के लिए किया जाता है.

JSON के काेड में दिखाना
{
  "relationalDescription": {
    object (LocalizedText)
  },
  "tags": [
    enum (Landmark.Tag)
  ],
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number,

  // Union field landmark can be only one of the following:
  "place": {
    object (PlaceView)
  }
  // End of list of possible types for union field landmark.
}
फ़ील्ड
relationalDescription

object (LocalizedText)

मंज़िल और लैंडमार्क के बीच के संबंध के बारे में ऐसी जानकारी जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण के लिए: "एंपायर स्टेट बिल्डिंग के पास" या "व्हाइट हाउस के सामने".

tags[]

enum (Landmark.Tag)

ऐसे टैग जिनसे पता चलता है कि डेस्टिनेशन के हिसाब से लैंडमार्क का इस्तेमाल कैसे किया जा सकता है.

straightLineDistanceMeters

number

सिर्फ़ आउटपुट के लिए. इस लैंडमार्क से डेस्टिनेशन तक की सीधी दूरी, मीटर में.

travelDistanceMeters

number

सिर्फ़ आउटपुट के लिए. इस लैंडमार्क से मंज़िल तक की पैदल दूरी, मीटर में.

यूनियन फ़ील्ड landmark. लैंडमार्क. landmark इनमें से सिर्फ़ एक हो सकता है:
place

object (PlaceView)

वह जगह जो इस लैंडमार्क को दिखाती है.

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 (LatLng)
  },
  "tags": [
    enum (Entrance.Tag)
  ],
  "place": string,
  "streetViewThumbnail": {
    object (StreetViewThumbnail)
  },
  "streetViewAnnotation": {
    object (ImageAnnotation)
  }
}
फ़ील्ड
location

object (LatLng)

एंट्री पॉइंट की जगह.

tags[]

enum (Entrance.Tag)

प्रवेश द्वार के बारे में बताने वाले टैग की सूची.

place

string

वह इमारत जिस पर यह दरवाज़ा मौजूद है. इसे places/{placeId} फ़ॉर्मैट में लिखें.

streetViewThumbnail

object (StreetViewThumbnail)

Street View की थंबनेल इमेज, जिसमें एंट्री पॉइंट दिख रहा है. Street View Static API से इमेज का अनुरोध किया जा सकता है. https://developers.google.com/maps/documentation/streetview/request-streetview देखें.

streetViewAnnotation

object (ImageAnnotation)

ऊपर दिखाए गए streetViewThumbnail पर, प्रवेश द्वार का एनोटेशन.

Entrance.Tag

एंट्रेंस के बारे में जानकारी देने वाली विशेषताएं.

Enums
TAG_UNSPECIFIED इस्तेमाल नहीं किया जाता.
PREFERRED

ऐसा हो सकता है कि मुख्य सड़क से अंदर जाने का रास्ता, खोज के नतीजों में दिखाए गए डेस्टिनेशन तक पहुंचने का रास्ता हो. किसी जगह में जाने के लिए कई पसंदीदा रास्ते हो सकते हैं. अगर किसी दरवाज़े पर यह टैग नहीं है, तो इसका मतलब है कि वह दरवाज़ा, मुख्य जगह वाली बिल्डिंग में ही है. हालांकि, यह ज़रूरी नहीं है कि उस दरवाज़े से जगह तक पहुंचा जा सके.

उदाहरण के लिए, अगर मुख्य जगह किसी स्ट्रिप मॉल में मौजूद रेस्टोरेंट है, तो "PREFERRED" एंट्री पॉइंट वे होंगे जो रेस्टोरेंट तक ले जाते हैं. वहीं, दिखाए गए अन्य एंट्री पॉइंट, इमारत के अन्य एंट्री पॉइंट होंगे. जैसे, स्ट्रिप मॉल में मौजूद अन्य रेस्टोरेंट के एंट्री पॉइंट.

अगर मुख्य जगह कोई इमारत है, तो PREFERRED के एंट्री पॉइंट वे होंगे जो इमारत के "मुख्य" हिस्से तक ले जाते हैं. उदाहरण के लिए, शॉपिंग सेंटर में PREFERRED प्रवेश द्वार वे होंगे जिनसे मुख्य फ़ोयर एरिया में जाया जा सकता है. हालांकि, अगर कोई प्रवेश द्वार सिर्फ़ इमारत के किनारे मौजूद किसी स्टोर में जाने की सुविधा देता है, तो वह PREFERRED प्रवेश द्वार नहीं होगा.

ध्यान दें: ऐसा हो सकता है कि 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

string

कोई खास पैनोरामा आईडी.

widthPx

integer

पिक्सल में, आउटपुट थंबनेल इमेज की चौड़ाई. ध्यान दें: थंबनेल के साथ एनोटेशन का अनुरोध करते समय, ऊंचाई और चौड़ाई की इन वैल्यू का इस्तेमाल Street View API के अनुरोध में किया जाना चाहिए. इससे यह पक्का किया जा सकेगा कि एनोटेशन के कोऑर्डिनेट, इमेज के साथ सही तरीके से अलाइन हों.

heightPx

integer

पिक्सल में, आउटपुट थंबनेल इमेज की लंबाई. ध्यान दें: थंबनेल के साथ एनोटेशन का अनुरोध करते समय, Street View API के अनुरोध में ऊंचाई और चौड़ाई की इन वैल्यू का इस्तेमाल करना ज़रूरी है. इससे यह पक्का किया जा सकेगा कि एनोटेशन के निर्देशांक, इमेज के साथ सही तरीके से अलाइन हों.

headingDegree

number

डिग्री में, कैमरे का हॉरिज़ॉन्टल ओरिएंटेशन. रेंज [0, 360). 0 का मतलब उत्तर और 90 का मतलब पूरब होता है.

pitchDegree

number

कैमरे का वर्टिकल ओरिएंटेशन, डिग्री में. रेंज [-90, 90]. 0 का मतलब क्षितिज है, +90 का मतलब सीधे ऊपर है, और -90 का मतलब सीधे नीचे है.

fovDegree

number

डिग्री में, हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू). रेंज (0, 180]. इससे ज़ूम करने का लेवल कंट्रोल किया जाता है. एफ़ओवी जितना कम होगा, ज़ूम उतना ही ज़्यादा होगा.

ImageAnnotation

इमेज के थंबनेल पर मौजूद एनोटेशन, जैसे कि किसी एंट्री पॉइंट को आउटलाइन करने वाला पॉलीगॉन.

JSON के काेड में दिखाना
{
  "coordinates": [
    {
      object (ImageAnnotation.Coordinate)
    }
  ]
}
फ़ील्ड
coordinates[]

object (ImageAnnotation.Coordinate)

निर्देशांकों की एक सूची, जो इमेज पर एक पॉलीगॉन बनाती है. निर्देशांकों को घड़ी की उलटी दिशा में क्रम से लगाया जाता है.

ImageAnnotation.Coordinate

इमेज पर मौजूद किसी पॉइंट का पिक्सल कोऑर्डिनेट. मूल बिंदु (0,0) इमेज के सबसे ऊपर बाएं पिक्सल का सबसे ऊपर बायां कोना होता है. इसमें x-ऐक्सिस दाईं ओर और y-ऐक्सिस नीचे की ओर होता है.

JSON के काेड में दिखाना
{
  "xPx": number,
  "yPx": number
}
फ़ील्ड
xPx

number

X कोऑर्डिनेट.

yPx

number

Y कोऑर्डिनेट.

Destination.ParkingOptions

मंज़िल पर पार्किंग के विकल्पों के बारे में जानकारी.

JSON के काेड में दिखाना
{
  "availability": enum (Destination.ParkingOptions.Availability),
  "onsiteParking": boolean,
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
फ़ील्ड
availability

enum (Destination.ParkingOptions.Availability)

इस मंज़िल पर पार्किंग की उपलब्धता.

onsiteParking

boolean

मंज़िल पर, ऑनसाइट पार्किंग की सुविधा मौजूद है.

freeParkingLot

boolean

मुफ़्त पार्किंग की सुविधा देता है.

paidParkingLot

boolean

पैसे चुकाकर पार्किंग करने की सुविधा देता है.

freeStreetParking

boolean

सड़क के किनारे मुफ़्त पार्किंग की सुविधा है.

paidStreetParking

boolean

सड़क के किनारे पार्किंग की सुविधा के लिए पैसे देने होंगे.

valetParking

boolean

वैले पार्किंग की सुविधा है.

freeGarageParking

boolean

गराज में मुफ़्त पार्किंग की सुविधा है.

paidGarageParking

boolean

यहां पैसे चुकाकर गराज में पार्किंग करने की सुविधा उपलब्ध है.

Destination.ParkingOptions.Availability

इस जगह पर जाने पर, पार्किंग ढूंढना कितना मुश्किल है, इसका कुल आकलन.

आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं.

Enums
AVAILABILITY_UNSPECIFIED पार्किंग की सुविधा उपलब्ध नहीं है.
PLENTY पार्किंग के लिए काफ़ी जगह है.
SOMEWHAT_DIFFICULT यहां पार्किंग की जगह मिलना कुछ हद तक मुश्किल है.
DIFFICULT पार्किंग मिलना बहुत मुश्किल है.

Destination.ArrivalSummary

मंज़िल पर पहुंचने के अनुभव के बारे में, एआई से बनाया गया कॉन्टेंट की खास जानकारी.

JSON के काेड में दिखाना
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUrl": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
फ़ील्ड
text

object (LocalizedText)

मंज़िल पर पहुंचने के अनुभव की खास जानकारी.

flagContentUrl

string

एक लिंक, जिस पर जाकर उपयोगकर्ता जवाब में मौजूद किसी समस्या की शिकायत कर सकते हैं.

disclosureText

object (LocalizedText)

सिर्फ़ आउटपुट के लिए. इसमें यात्रा के बारे में जानकारी देने वाले टेक्स्ट के बारे में बताया गया है.