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

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

يمكن أن يتضمّن الردّ من Text Search (New) وNearby Search (New) وPlace Details (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 إنشاء رابط الاتجاهات في الردّ. يتم استخدام الموقع الجغرافي الحالي كنقطة بداية، ويتم استخدام الموقع الجغرافي للمكان كوجهة، ويتم استخدام وضع التنقّل "القيادة".

يستخدم المثال التالي ميزة "البحث القريب" (الجديدة) لتضمين رابط اتجاهات الخريطة في الرد في الحقل 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 .

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