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

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

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

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

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

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

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

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

جرِّبه الآن

روابط "خرائط 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 إنشاء رابط الاتجاهات في الردّ. يتم استخدام الموقع الجغرافي الحالي كنقطة بداية، وموقع المكان كنقطة نهاية، ووسيلة النقل هي السيارة.

يستخدم المثال التالي واجهة برمجة التطبيقات Nearby Search (New) لتضمين رابط اتجاهات الخرائط في الردّ في الحقل 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. في لوحة مستكشف واجهات برمجة التطبيقات، انقر على fullscreen .

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