Google Maps से लिंक करना

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

Text Search (नया), Nearby Search (नया) और Place Details (नया) के रिस्पॉन्स में, Google Maps के लिंक भी शामिल हो सकते हैं. आपके उपयोगकर्ता, Google Maps के इन लिंक को ब्राउज़ करके, रिस्पॉन्स में किसी जगह के बारे में ज़्यादा जानकारी देख सकते हैं.

उदाहरण के लिए, आपने कैलिफ़ोर्निया के सैन फ़्रांसिस्को में मौजूद हवाई अड्डों को खोजा. इसके बाद, रिस्पॉन्स में सैन फ़्रांसिस्को इंटरनेशनल एयरपोर्ट (एसएफ़ओ) को जगहों की सूची में शामिल किया जाता है. रिस्पॉन्स में एसएफ़ओ के लिए Place ऑब्जेक्ट, googleMapsUri फ़ील्ड जोड़ता है. इसमें Google Maps के लिंक होते हैं. इनकी मदद से, Google Maps को उस जगह के लिए खोला जा सकता है. साथ ही, उस जगह के लिए निर्देश, समीक्षाएं, और फ़ोटो देखी जा सकती हैं.

Place ऑब्जेक्ट में जोड़े गए लिंक के साथ-साथ, रिस्पॉन्स में googleMapsUri फ़ील्ड भी Reviews और Photos ऑब्जेक्ट में जोड़ा जाता है:

• Reviews.googleMapsUri: इसमें समीक्षा के लिए Google Maps का लिंक होता है, ताकि इसे ब्राउज़र में देखा जा सके.

• Photos.googleMapsUri: इसमें फ़ोटो के लिए Google Maps का लिंक होता है, ताकि इसे ब्राउज़र में देखा जा सके.

API एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको इन नए विकल्पों के बारे में जानकारी मिल सकती है:

इसे आज़माएं!

किसी जगह के लिए Google Maps के काम करने वाले लिंक

यहां दी गई टेबल में, Google Maps के उन लिंक के बारे में बताया गया है जिन्हें रिस्पॉन्स में शामिल किया जा सकता है:

जगहों की जानकारी के रिस्पॉन्स में सभी लिंक शामिल करना

जगहों की जानकारी के रिस्पॉन्स में मौजूद लिंक, googleMapsLinks फ़ील्ड में शामिल होते हैं. अगर आपको ये लिंक रिस्पॉन्स में दिखाने हैं, तो पक्का करें कि आपने अनुरोध के फ़ील्ड मास्क में googleMapsLinks फ़ील्ड शामिल किया हो.

उदाहरण के लिए, यहां दिए गए Text Search (नया) में, रिस्पॉन्स में Maps के सभी लिंक शामिल हैं:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

रिस्पॉन्स इस फ़ॉर्म में होता है:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

रिस्पॉन्स में कोई खास लिंक शामिल करना

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

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

रिस्पॉन्स में निर्देश शामिल करना

जगहों की जानकारी के सभी तरीकों से, रिस्पॉन्स में निर्देशों का लिंक जनरेट किया जा सकता है. इसमें, मौजूदा जगह को शुरुआती जगह के तौर पर, जगह की जानकारी को डेस्टिनेशन के तौर पर, और यात्रा के मोड को ड्राइव के तौर पर इस्तेमाल किया जाता है.

अगले उदाहरण में, Nearby Search (नया) का इस्तेमाल करके, रिस्पॉन्स में Maps के निर्देशों का लिंक, directionsUri फ़ील्ड में शामिल किया गया है:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

समीक्षाओं और फ़ोटो के लिंक शामिल करना

इस रिलीज़ में, रिस्पॉन्स में मौजूद Reviews और Photos ऑब्जेक्ट में googleMapsUri फ़ील्ड जोड़ा गया है. इन लिंक को ब्राउज़ करने पर, समीक्षा या फ़ोटो Google Maps में खुलती है.

उदाहरण के लिए, यहां दिए गए Text Search (नया) में, रिस्पॉन्स में हर जगह के लिए समीक्षाएं और फ़ोटो शामिल हैं:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

रिस्पॉन्स में, समीक्षाओं और फ़ोटो के कलेक्शन के हर एलिमेंट में googleMapsUri फ़ील्ड शामिल होता है. इससे समीक्षा या फ़ोटो को ब्राउज़र में खोला जा सकता है.

इसे आज़माएं!

API एक्सप्लोरर की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिल सकती है.

1. पेज की दाईं ओर मौजूद, api एपीआई आइकॉन को चुनें.

2. ज़रूरी नहीं है, लेकिन सामान्य पैरामीटर दिखाएं को बड़ा करें और fields पैरामीटर को फ़ील्ड मास्क पर सेट करें.

3. ज़रूरी नहीं है, लेकिन अनुरोध का मुख्य हिस्सा में बदलाव करें.

4. अनुरोध भेजें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध भेजना है.

5. API एक्सप्लोरर पैनल में, fullscreen को चुनें

   API एक्सप्लोरर विंडो को बड़ा करने के लिए, फ़ुलस्क्रीन को चुनें.