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

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

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

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

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

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

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

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

इसे आज़माएं!

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

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

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

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

उदाहरण के लिए, टेक्स्ट से खोजें (नया) सुविधा के इस अनुरोध के जवाब में, 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 के सभी तरीके, जवाब में निर्देश वाले लिंक जनरेट करने की सुविधा देते हैं. मौजूदा जगह को शुरुआती जगह के तौर पर इस्तेमाल किया जाता है. साथ ही, जगह की जानकारी को मंज़िल के तौर पर इस्तेमाल किया जाता है. यात्रा का मोड, ड्राइव होता है.

अगले उदाहरण में, आस-पास की जगहों की जानकारी (नया वर्शन) का इस्तेमाल करके, 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 में खुलती है.

उदाहरण के लिए, टेक्स्ट से खोजें (नया) सुविधा के इस अनुरोध के जवाब में, हर जगह के लिए समीक्षाएं और फ़ोटो शामिल हैं:

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 फ़ील्ड शामिल होता है. इससे समीक्षा या फ़ोटो को ब्राउज़र में खोला जा सकता है.

इसे आज़माएं!

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

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

2. इसके अलावा, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और fields पैरामीटर को फ़ील्ड मास्क पर सेट करें.

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

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

5. API Explorer पैनल में, fullscreen को चुनें

   फ़ुलस्क्रीन, ताकि एपीआई एक्सप्लोरर विंडो को बड़ा किया जा सके.