رابط إلى "خرائط 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" للصورة لتتمكّن من عرضها في متصفّح.

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

جرِّبه الآن

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

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

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

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

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

يضيف هذا الإصدار الحقل 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

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