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

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

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

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

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

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

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

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

इसे आज़माएं!

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

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

Places API के जवाब में सभी लिंक शामिल करना

Places API के जवाब में मौजूद लिंक, 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'

जवाब में निर्देश शामिल करना

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

अगले उदाहरण में, 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 एक्सप्लोरर विंडो को बड़ा करने के लिए, फ़ुलस्क्रीन को चुनें.