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

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

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

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

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

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

    Reviews.googleMapsUri

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

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

جرِّبه الآن

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

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

تتضمّن الروابط في استجابة الأماكن الحقل googleMapsLinks. احرص على تضمين الحقل googleMapsLinks في قناع الحقول للطلب إذا كنت تريد ظهوره في الاستجابة.

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

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

على سبيل المثال، يتضمّن Text Search (الجديدة) التالي المراجعات والصور لكل مكان في الاستجابة:

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 لفتح المراجعة أو الصورة في متصفّح.

جرِّبه الآن

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

  1. انقر على رمز واجهة برمجة التطبيقات على الجانب الأيسر من الصفحة.

  2. يمكنك اختياريًا توسيع عرض المَعلمات العادية وضبط المَعلمة fields على قناع الحقول.

  3. يمكنك اختياريًا تعديل نص الطلب.

  4. انقر على الزر تنفيذ. في مربع الحوار، اختَر الحساب الذي تريد استخدامه لإجراء الطلب.

  5. في لوحة API Explorer، انقر على

    ملء الشاشة لتوسيع نافذة API Explorer