رابط إلى "خرائط Google"

تقبل Places API (الجديدة) طلبات بيانات الأماكن من خلال مجموعة متنوعة من الطرق. تحتوي استجابة Places API (الجديدة) على بيانات حول مكان، بما في ذلك بيانات الموقع الجغرافي والصور والمواقع الجغرافية ونقاط الاهتمام البارزة.

يمكن أن يتضمّن الردّ من البحث النصي (New) وبحث في الجوار (New) وتفاصيل المكان (New) أيضًا روابط تؤدي إلى "خرائط Google". يمكن للمستخدمين الانتقال إلى روابط "خرائط Google" هذه للاطّلاع على معلومات إضافية حول مكان معيّن في الردّ.

على سبيل المثال، تبحث عن مطارات في سان فرانسيسكو، كاليفورنيا. يتضمّن الردّ بعد ذلك مطار سان فرانسيسكو الدولي (SFO) في قائمة الأماكن. يضيف العنصر Place الخاص بمطار سان فرانسيسكو الدولي في الردّ الحقل googleMapsUri الذي يتضمّن روابط "خرائط Google" لفتح "خرائط Google" وعرض المكان، والاتجاهات إلى المكان، ومراجعات المكان، وصور المكان.

بالإضافة إلى الروابط التي تمت إضافتها إلى الكائن Place، تتم أيضًا إضافة الحقل googleMapsUri إلى الكائنين Reviews وPhotos في الرد:

• Reviews.googleMapsUri: يحتوي على رابط إلى المراجعة على "خرائط Google"، ما يتيح لك الاطّلاع عليها في المتصفّح.

• Photos.googleMapsUri: يحتوي على رابط إلى الصورة في "خرائط Google" لتتمكّن من عرضها في المتصفّح.

يتيح لك API Explorer إمكانية تقديم طلبات مباشرة حتى تتمكّن من التعرّف على الخيارات الجديدة التالية:

جرِّبه الآن

روابط الأماكن المتوافقة مع "خرائط Google"

يوضّح الجدول التالي روابط "خرائط Google" التي يمكنك تضمينها في الردّ:

تضمين جميع الروابط في الردّ على طلب البحث في "أماكن Google"

تتضمّن الروابط في ردّ الأماكن الحقل googleMapsLinks. احرص على تضمين الحقل googleMapsLinks في قناع الحقل الخاص بالطلب إذا كنت تريد أن يظهر في الرد.

على سبيل المثال، يتضمّن "البحث النصي (جديد)" التالي جميع روابط "خرائط Google" في الردّ:

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

تضمين روابط المراجعات والصور

يضيف هذا الإصدار الحقل googleMapsUri إلى العنصرَين Reviews و Photos في الردّ. يؤدي الانتقال إلى هذه الروابط إلى فتح المراجعة أو الصورة في "خرائط Google".

على سبيل المثال، يتضمّن البحث النصي (الجديد) التالي مراجعات وصورًا لكل مكان في الردّ:

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 على الجانب الأيسر من الصفحة.

2. يمكنك اختياريًا توسيع عرض المَعلمات العادية وضبط المَعلمة fields على قناع الحقل.

3. يمكنك اختياريًا تعديل نص الطلب.

4. انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.

5. في لوحة API Explorer، انقر على fullscreen .

   ملء الشاشة لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات"