تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

بالإضافة إلى الروابط التي تمت إضافتها إلى عنصر Place، يضيف هذا الإصدار أيضًا الحقل googleMapsUri إلى العنصرَين Reviews و Photos في الاستجابة:

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

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

جرِّبه الآن

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

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

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

الأسعار

هذه الميزة في مرحلة معاينة الإصدار العلني، ولا يتم تحصيل أي رسوم، ما يعني أنّه لن يتم تحصيل أي رسوم مقابل استخدامها خلال مرحلة المعاينة. لمعرفة تفاصيل الأسعار المقترَحة، يُرجى الاطّلاع على استخدام Places API والفواتير.

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

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

يستخدم المثال التالي ميزة "البحث عن الأماكن القريبة" لتضمين رابط الاتجاهات في خرائط Google في الردّ في الحقل 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 على قناع الحقل.
يمكنك اختياريًا تعديل نص الطلب.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز التوسيع لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".