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

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

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

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

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

कीमत

फ़िलहाल, यह सुविधा Pre-GA Preview स्टेज में है. इसके लिए, कोई शुल्क नहीं लिया जाता. इसका मतलब है कि Preview के दौरान, इसके इस्तेमाल के लिए बिलिंग $0 है. सुझाई गई कीमत के बारे में ज़्यादा जानने के लिए, Places API (नया) के इस्तेमाल और बिलिंग के बारे में जानकारी देखें.

'जगहें' के जवाब में सभी लिंक शामिल करें

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

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

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. एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, बड़ा करें आइकॉन चुनें.