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

यह प्रॉडक्ट या सुविधा, झलक (Pre-GA) के तौर पर उपलब्ध है. ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरण के बारे में जानकारी देखें.

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

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

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

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

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

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

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

इसे आज़माएं!

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

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

Google Maps का लिंक	ब्यौरा	फ़ील्ड का नाम
जगह	जगह पर Google Maps खोलने का लिंक.	googleMapsLinks.placeUri
निर्देश	Google Maps में जगह के लिए निर्देश खोलने का लिंक.	googleMapsLinks.directionsUri
समीक्षा लिखें	Google Maps में किसी जगह की समीक्षा करने के लिए लिंक.	googleMapsLinks.writeAReviewUri
समीक्षाएं पढ़ें	जगह की Google Maps समीक्षाएं दिखाने के लिए लिंक.	googleMapsLinks.reviewsUri
Photos	Google Maps में जगह की फ़ोटो दिखाने के लिए लिंक.	googleMapsLinks.photosUri

ध्यान दें: इस रिलीज़ में, समीक्षा पढ़ने या लिखने और किसी जगह की फ़ोटो देखने के लिंक, सिर्फ़ Google Maps के वेब वर्शन पर काम करते हैं. ये Google Maps के मोबाइल वर्शन पर काम नहीं करते.

कीमत

यह सुविधा, GA के रिलीज़ होने से पहले की झलक के तौर पर उपलब्ध है. इसके लिए कोई शुल्क नहीं लिया जाता. इसका मतलब है कि झलक के दौरान, बिलिंग के लिए 0 डॉलर चुकाने होंगे. सुझाई गई कीमत के बारे में ज़्यादा जानने के लिए, Places API के इस्तेमाल और बिलिंग देखें.

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

जगहों के जवाब में मौजूद लिंक, googleMapsLinks फ़ील्ड में होते हैं. अगर आपको जवाब में 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"
      }
    }
  ]
}

ध्यान दें: इस रिलीज़ से पहले, रिस्पॉन्स में मौजूद Place ऑब्जेक्ट में place.googleMapsURI फ़ील्ड शामिल था. इसमें, जगह का Google Maps लिंक होता था. रिस्पॉन्स में मौजूद नए place.googleMapsLinks.placeURI फ़ील्ड में वही वैल्यू है जो place.googleMapsURI में है.

जवाब में कोई लिंक शामिल करना

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

ध्यान दें: टेक्स्ट सर्च और आस-पास के कारोबारों को खोजने की सुविधा के लिए, routingParameters request पैरामीटर का इस्तेमाल करके, ऑरिजिन की जानकारी दी जा सकती है. हालांकि, ऐसा करना ज़रूरी नहीं है. अनुरोध पैरामीटर का असर, जवाब में रास्ते की खास जानकारी और रास्ते पर खोज पर पड़ता है. हालांकि, Google Maps के निर्देशों का हिसाब हमेशा मौजूदा जगह से लगाया जाता है.

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

इस रिलीज़ में, रिस्पॉन्स में 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. पेज की दाईं ओर मौजूद, एपीआई आइकॉन को चुनें.

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

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

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

5. एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, बड़ा करें आइकॉन चुनें.