تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

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

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

ملاحظة: بالنسبة إلى مكان معيّن، يحتوي الحقل ReviewSummary.reviewsUri في العنصر ReviewSummary على الرابط نفسه الذي يتضمّنه الحقل Reviews.googleMapsUri.
‫Photos.googleMapsUri: يحتوي على رابط إلى الصورة في "خرائط Google" ليمكنك عرضها في المتصفّح.

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

جرِّبه الآن

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

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

رابط إلى "خرائط Google"	الوصف	اسم الحقل
المكان	رابط لفتح "خرائط Google" وعرض المكان	`googleMapsLinks.placeUri`
الاتجاهات	رابط لفتح اتجاهات الوصول إلى المكان في "خرائط Google"	`googleMapsLinks.directionsUri`
كتابة مراجعة	رابط لكتابة مراجعة عن المكان في "خرائط Google"	`googleMapsLinks.writeAReviewUri`
قراءة المراجعات	رابط لعرض مراجعات المكان على "خرائط Google"	`googleMapsLinks.reviewsUri`
الصور	رابط لعرض صور المكان في "خرائط Google"	`googleMapsLinks.photosUri`

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

تتضمّن الروابط في ردّ الأماكن الحقل 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 لفتح المراجعة أو الصورة في متصفّح.

جرِّبها الآن.

يتيح لك "مستكشف واجهات برمجة التطبيقات" إرسال طلبات نموذجية لتتعرّف على واجهة برمجة التطبيقات وخياراتها.

انقر على رمز واجهة برمجة التطبيقات على الجانب الأيسر من الصفحة.
يمكنك اختياريًا توسيع عرض المَعلمات العادية وضبط المَعلمة fields على قناع الحقل.
يمكنك اختياريًا تعديل نص الطلب.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة API Explorer، انقر على .

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