تفاصيل المكان (جديد)

اختيار النظام الأساسي: Android iOS JavaScript Web Service
مطوّرو المنطقة الاقتصادية الأوروبية (EEA)

مقدمة

بعد الحصول على رقم تعريف مكان، يمكنك طلب مزيد من التفاصيل حول منشأة أو نقطة اهتمام معيّنة من خلال بدء طلب تفاصيل المكان (الجديد) طلب. يعرض طلب تفاصيل المكان (الجديد) معلومات أكثر شمولاً عن المكان المحدّد، مثل عنوانه الكامل ورقم هاتفه وتقييم المستخدمين ومراجعاتهم.

هناك طرق عديدة للحصول على رقم تعريف مكان. يمكنك استخدام:

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

طلبات تفاصيل المكان (الجديد)

طلب تفاصيل المكان (الجديد) هو طلب HTTP GET بالتنسيق التالي:

https://places.googleapis.com/v1/places/PLACE_ID

مرِّر جميع المعلمات كمعلمات عنوان URL أو في العناوين كجزء من طلب استرداد بيانات باستخدام GET. على سبيل المثال:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

أو في أمر curl:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

ردود تفاصيل المكان (الجديد)

يعرض طلب تفاصيل المكان (الجديد) كائن JSON كاستجابة. في الردّ:

  • يتم تمثيل الردّ باستخدام كائن Place. يحتوي كائن Place على معلومات مفصّلة عن المكان.
  • تحدّد السمة FieldMask التي تم تمريرها في الطلب قائمة الحقول التي يتم عرضها في الكائن Place.

يكون كائن JSON الكامل بالتنسيق التالي:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

المعلمات المطلوبة

  • FieldMask

    حدِّد قائمة الحقول التي سيتم عرضها في الردّ من خلال إنشاء قناع حقول الردّ. مرِّر قناع حقول الردّ إلى الطريقة باستخدام مَعلمة عنوان URL‏ $fields أو fields، أو باستخدام عنوان HTTP‏ X-Goog-FieldMask. لا توجد قائمة تلقائية بالحقول التي يتم عرضها في الردّ. إذا لم تحدّد قناع الحقول، ستعرض الطريقة خطأً.

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

    حدِّد قائمة قيم مفصولة بفاصلة لأنواع بيانات المكان التي سيتم عرضها. على سبيل المثال، لاسترداد الاسم المعروض وعنوان المكان:

    X-Goog-FieldMask: displayName,formattedAddress

    استخدِم * لاسترداد جميع الحقول.

    X-Goog-FieldMask: *

    حدِّد واحدًا أو أكثر من الحقول التالية:

    • تؤدي الحقول التالية إلى تفعيل رمز التخزين التعريفي "تفاصيل المكان: أرقام التعريف الأساسية فقط":

      attributions
      consumerAlert
      id
      movedPlace
      movedPlaceId
      name*
      photos

      * يحتوي الحقل name على اسم مورد المكان بالتنسيق: places/PLACE_ID. للحصول على الاسم النصي للمكان، اطلب الحقل displayName في رمز التخزين التعريفي Pro.

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى مراجعة حقول بيانات المكان (الجديد).

    • تؤدي الحقول التالية إلى تفعيل رمز التخزين التعريفي "تفاصيل المكان: أساسي":

      addressComponents
      addressDescriptor*
      adrFormatAddress
      formattedAddress
      location
      plusCode
      postalAddress
      shortFormattedAddress
      types
      viewport

      * تتوفّر واصفات العناوين بشكل عام للعملاء في الهند، وهي تجريبية في أماكن أخرى.

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى مراجعة حقول بيانات المكان (الجديد).

    • تؤدي الحقول التالية إلى تفعيل رمز التخزين التعريفي "تفاصيل المكان: Pro":

      accessibilityOptions
      businessStatus
      containingPlaces
      displayName
      googleMapsLinks
      googleMapsTypeLabel
      googleMapsUri
      iconBackgroundColor
      iconMaskBaseUri
      openingDate
      primaryType
      primaryTypeDisplayName
      pureServiceAreaBusiness
      subDestinations
      timeZone
      utcOffsetMinutes

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى مراجعة حقول بيانات المكان (الجديد).

    • تؤدي الحقول التالية إلى تفعيل رمز التخزين التعريفي "تفاصيل المكان: Enterprise":

      currentOpeningHours
      currentSecondaryOpeningHours
      internationalPhoneNumber
      nationalPhoneNumber
      priceLevel
      priceRange
      rating
      regularOpeningHours
      regularSecondaryOpeningHours
      transitStation
      userRatingCount
      websiteUri

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى مراجعة حقول بيانات المكان (الجديد).

    • تؤدي الحقول التالية إلى تفعيل رمز التخزين التعريفي "تفاصيل المكان: Enterprise + الأجواء":

      allowsDogs
      curbsidePickup
      delivery
      dineIn
      editorialSummary
      evChargeAmenitySummary
      evChargeOptions
      fuelOptions
      generativeSummary
      goodForChildren
      goodForGroups
      goodForWatchingSports
      liveMusic
      menuForChildren
      neighborhoodSummary
      parkingOptions
      paymentOptions
      outdoorSeating
      reservable
      restroom
      reviews
      reviewSummary
      routingSummaries*
      servesBeer
      servesBreakfast
      servesBrunch
      servesCocktails
      servesCoffee
      servesDessert
      servesDinner
      servesLunch
      servesVegetarianFood
      servesWine
      takeout

      * البحث النصي والبحث في الأماكن القريبة فقط

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى مراجعة حقول بيانات المكان (الجديد).

  • placeId

    معرّف نصي يحدّد مكانًا بشكل فريد، ويتم عرضه من خلال البحث النصي (الجديد) أو البحث في الأماكن القريبة (الجديد). لمزيد من المعلومات عن أرقام تعريف الأماكن، يُرجى الاطّلاع على نظرة عامة على أرقام تعريف الأماكن.

    يُطلق على السلسلة places/PLACE_ID أيضًا اسم مورد المكان . في الردّ على طلب تفاصيل المكان (الجديد)، البحث في الأماكن القريبة (الجديد)، والبحث النصي (الجديد) ، يتم تضمين هذه السلسلة في الحقل name للردّ. يتم تضمين رقم تعريف المكان المستقل في الحقل id للردّ.

المعلمات الاختيارية

  • languageCode

    اللغة التي سيتم عرض النتائج بها.

    • اطّلِع على قائمة اللغات المتاحة. تُحدّث Google اللغات المتاحة بشكل متكرر، لذا قد لا تكون هذه القائمة شاملة.
    • إذا لم يتم تقديم languageCode، ستضبط واجهة برمجة التطبيقات القيمة تلقائيًا على en. إذا حدّدت رمز لغة غير صالح، ستعرض واجهة برمجة التطبيقات الخطأ INVALID_ARGUMENT
    • تبذل واجهة برمجة التطبيقات قصارى جهدها لتقديم عنوان شارع يمكن قراءته لـ لكل من المستخدم والسكان المحليين. لتحقيق هذا الهدف، تعرض واجهة برمجة التطبيقات عناوين الشوارع باللغة المحلية، مع نقلها إلى نص يمكن للمستخدم قراءته إذا لزم الأمر، مع مراعاة اللغة المفضّلة. يتم عرض جميع العناوين الأخرى باللغة المفضّلة. يتم عرض جميع مكوّنات العنوان باللغة نفسها، التي يتم اختيارها من المكوّن الأول.
    • إذا لم يتوفّر اسم باللغة المفضّلة، تستخدم واجهة برمجة التطبيقات الـ أقرب نتيجة مطابِقة.
    • تؤثر اللغة المفضّلة بشكل طفيف في مجموعة النتائج التي تختار واجهة برمجة التطبيقات عرضها، والترتيب الذي يتم عرضها به. يفسّر برنامج الترميز الجغرافي الاختصارات بشكل مختلف حسب اللغة، مثل اختصارات أنواع الشوارع أو المرادفات التي قد تكون صالحة في لغة واحدة ولكن ليس في لغة أخرى.

  • regionCode

    رمز المنطقة المستخدَم لتنسيق الردّ، ويتم تحديده كقيمة رمز CLDR مكوّنة من حرفَين. لا توجد قيمة تلقائية.

    إذا كان اسم البلد في الحقل formattedAddress في الردّ يطابق regionCode، يتم حذف رمز البلد من formattedAddress. لا تؤثر هذه المَعلمة في adrFormatAddress، الذي يتضمّن دائمًا اسم البلد ، أو في shortFormattedAddress، الذي لا يتضمّنه أبدًا.

    تتطابق معظم رموز CLDR مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD للمملكة المتحدة هو "uk" (.co.uk)، بينما رمز ISO 3166-1 هو "gb" (من الناحية الفنية، يشير إلى كيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية"). يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري.

  • sessionToken

    رموز الجلسات هي سلاسل من إنشاء المستخدمين لتتبُّع طلبات الإكمال التلقائي (الجديد) على أنّها "جلسات". يستخدم الإكمال التلقائي (الجديد) رموز الجلسات لـ تجميع مراحل طلب البحث واختيار المكان في بحث الإكمال التلقائي للمستخدم في جلسة منفصلة لأغراض الفوترة. يتم تمرير رموز الجلسات إلى طلبات تفاصيل المكان (الجديد) التي تلي طلبات الإكمال التلقائي (الجديد). لمزيد من المعلومات، يُرجى الاطّلاع على رموز الجلسات.

مثال على طلب تفاصيل المكان (الجديد)

يطلب المثال التالي تفاصيل مكان حسب placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

يُرجى العِلم أنّ عنوان X-Goog-FieldMask يحدّد أنّ الردّ يحتوي على حقول البيانات التالية: id,displayName. يكون الردّ بعد ذلك بالتنسيق التالي:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

أضِف المزيد من أنواع البيانات إلى قناع الحقول لعرض معلومات إضافية. على سبيل المثال، أضِف formattedAddress,plusCode لتضمين الـ عنوان والرمز البريدي في الـ ردّ:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

يكون الردّ الآن بالتنسيق التالي:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

الحصول على واصفات العناوين

تقدّم واصفات العناوين معلومات ذات صلة بموقع المكان، بما في ذلك المعالم القريبة والمناطق التي يحتوي عليها.

يعرض المثال التالي طلب تفاصيل المكان (الجديد) لمتجر متعدد الأقسام في مركز تجاري في سان خوسيه. في هذا المثال، يمكنك تضمين addressDescriptors في قناع الحقول:

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

يتضمّن الردّ المكان المحدّد في الطلب، وقائمة بالمعالم القريبة والمسافة بينها وبين المكان، وقائمة بالمناطق وعلاقة الاحتواء الخاصة بها بالمكان:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

الحصول على تفاصيل مكان تم نقله

إذا تم نقل مكان تتم الإشارة إليه في تطبيقك، يمكنك استخدام الحقلَين movedPlace وmovedPlaceId للحصول على تفاصيل المكان الجديد.

بالنسبة إلى الأماكن المغلقة نهائيًا، يعرض طلب تفاصيل المكان (الجديد) CLOSED_PERMANENTLY في الحقل businessStatus ويحذف الحقلَين movedPlace و movedPlaceId في نص الردّ.

بالنسبة إلى الأماكن التي تم نقلها إلى موقع جديد، يعرض طلب تفاصيل المكان (الجديد) CLOSED_PERMANENTLY في الحقل businessStatus ويعرض الموقع الجديد في الحقلَين movedPlace وmovedPlaceId في نص الردّ.

بالنسبة إلى الأماكن التي لم يتم نقلها، لا يعرض طلب تفاصيل المكان (الجديد) movedPlace أو movedPlaceId في نص الردّ.

يطلب المثال التالي معلومات عن مكان Marche IGA St-Canut في كيبيك، كندا:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

يعرض الطلب الردّ التالي:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

لطلب تفاصيل عن المكان الجديد، استخدِم اسم مورد المكان في الحقل movedPlace في طلب تفاصيل المكان (الجديد) جديد.

بالنسبة إلى الأماكن التي تم نقلها عدة مرات، قد يتطلب الحصول على تفاصيل عن الموقع الجغرافي الحالي عدة طلبات تفاصيل المكان (الجديد) متسلسلة. يشير الحقلان movedPlace و movedPlaceId لنتيجة مكان إلى الموقع الجغرافي التالي فقط، وليس إلى آخر موقع جغرافي معروف. يكون المكان في موقعه الجغرافي الحالي إذا حذف طلب تفاصيل المكان (الجديد) الحقلَين movedPlace وmovedPlaceId في نص الردّ.

العثور على المؤسسات التي سيتم افتتاحها في المستقبل

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

يعرض المثال التالي طلب بحث في الأماكن القريبة (الجديد) عن مؤسسة سيتم افتتاحها في الـ مستقبل في نيو ميدوز، أيداهو:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

يتضمّن الردّ حالة المؤسسة وتاريخ الافتتاح المتوقّع:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

الحصول على معلومات عن محطة النقل العام

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

يعرض المثال التالي طلب معلومات عن محطة النقل العام في محطة غراند سنترال:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,transitStation" \
"https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"

يتضمّن نص الردّ معلومات عن كل محطة ضمن النطاق، والخطوط التي تخدمها المحطة، والتنبيهات الصادرة عن مؤسسات النقل العام في تلك المحطة، ومعلومات المغادرة:

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

الحصول على المداخل ونقاط التنقّل

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

تعرض نقاط التنقّل navigationPointToken. يمكنك تمرير هذا الرمز إلى Navigation SDK (متاح لنظامَي التشغيل Android أو iOS) أو Routes API لتوجيه السائقين إلى هذا الموقع الجغرافي المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على رموز نقاط التنقّل.

يطلب المثال التالي تفاصيل عن مطار سان فرانسيسكو الدولي (رقم تعريف المكان ChIJVVVVVYx3j4ARP-3NGldc8qQ)، بما في ذلك entrances وnavigationPoints في قناع الحقول:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \
https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ

يتضمّن الردّ المداخل ونقاط التنقّل للمكان:

{
  "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
  "displayName": {
    "text": "San Francisco International Airport",
    "languageCode": "en"
  },
  "entrances": [
    {
      "location": {
        "latitude": 37.6172154,
        "longitude": -122.3839724
      }
    },
    {
      "location": {
        "latitude": 37.6174073,
        "longitude": -122.384196
      }
    },
    ...
  ],
  "navigationPoints": [
    {
      "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
      "displayName": {
        "text": "International Terminal Departures Level",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6153121,
        "longitude": -122.3900833
      },
      "travelModes": ["WALK"]
    },
    {
      "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
      "displayName": {
        "text": "Domestic Garage - SFO Short Term Parking",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6157153,
        "longitude": -122.3885012
      },
      "travelModes": ["DRIVE", "WALK"],
      "usages": ["PARKING"]
    },
    ...
  ]
}

جرِّبه الآن

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

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

  2. (اختياري) عدِّل مَعلمات الطلب.

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

  4. في لوحة مستكشف واجهات برمجة التطبيقات، انقر على رمز ملء الشاشة fullscreen لتوسيع نافذة مستكشف واجهات برمجة التطبيقات.