مقدمة
بعد الحصول على رقم تعريف المكان، يمكنك طلب المزيد من التفاصيل عن مؤسسة أو معلم جذب معيّن من خلال إرسال طلب تفاصيل المكان (جديد). يؤدي طلب "تفاصيل المكان (الجديد)" إلى عرض معلومات أكثر شمولاً عن المكان المحدّد، مثل عنوانه الكامل ورقم هاتفه وتقييمات المستخدمين ومراجعاتهم.
هناك طرق متعددة للحصول على رقم تعريف المكان. يمكنك استخدام:
- البحث النصي (جديد) أو بحث في الجوار (جديد)
- Geocoding API
- Routes API
- Address Validation API
- الإكمال التلقائي (جديد)
تتيح لك أداة "مستكشف واجهات برمجة التطبيقات" إجراء طلبات مباشرة حتى تتمكّن من التعرّف على واجهة برمجة التطبيقات وخياراتها:
طلبات تفاصيل المكان (جديد)
طلب "تفاصيل المكان (جديد)" هو طلب 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
ردود تفاصيل المكان (جديد)
تعرض واجهة برمجة التطبيقات Place Details (New) عنصر JSON كاستجابة. في الردّ:
- يتم تمثيل الردّ باستخدام عنصر
Place. يحتوي العنصرPlaceعلى معلومات تفصيلية عن المكان. - يحدّد FieldMask الذي تم تمريره في الطلب قائمة الحقول التي يتم عرضها في كائن
Place.
يكون عنصر JSON الكامل على النحو التالي:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
المعلمات المطلوبة
-
FieldMask
حدِّد قائمة الحقول التي تريد عرضها في الردّ من خلال إنشاء قناع حقل ردّ. مرِّر قناع حقل الاستجابة إلى الطريقة باستخدام مَعلمة عنوان URL
$fieldsأوfields، أو باستخدام عنوان HTTPX-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 + Atmosphere:
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 لتضمين
العنوان ورمز Plus Code في
الردّ:
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" } }
الحصول على التقييمات وعدد المراجعات والمراجعات
لاسترداد متوسط التقييم بالنجوم لمؤسسة أو إجمالي عدد التقييمات
(إجمالي المراجعات) أو نص مراجعة العميل، يجب تضمين الحقول المقابلة في
رأس X-Goog-FieldMask:
ratingوuserRatingCount: لعرض متوسط تقييم المكان (من1.0إلى5.0) وإجمالي عدد المراجعات. يؤدي طلب هذه الحقول إلى تفعيل رمز التخزين التعريفي لرزمة الشركات لتفاصيل المكان.reviewsوreviewSummary: تعرض ما يصل إلى خمسة عناصرReviewأرسلها المستخدمون وملخّص للمراجعات من إنشاء الذكاء الاصطناعي. يؤدي طلب هذه الحقول إلى تفعيل رمز التخزين التعريفي Enterprise + Atmosphere لتفاصيل المكان.
إذا كان تطبيقك يحتاج فقط إلى التقييم بالنجوم وإجمالي عدد المراجعات، اطلب
rating
و
userRatingCount
بدون
reviews
ليظل الطلب في
فئة رمز التخزين التعريفي لميزة "تفاصيل المكان" للمؤسسات:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
لاسترداد ما يصل إلى خمسة عناصر
Review
أرسلها المستخدمون، أضِف
reviews
إلى قناع الحقل (تتم الفوترة على مستوى
رمز التخزين التعريفي Enterprise + Atmosphere لتفاصيل المكان):
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
يتضمّن الردّ التقييم وإجمالي عدد التقييمات ومصفوفة
reviews
:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" }, "rating": 4.2, "userRatingCount": 2594, "reviews": [ { "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...", "relativePublishTimeDescription": "a month ago", "rating": 5, "text": { "text": "Iconic tech campus with visitor areas and cafes.", "languageCode": "en" }, "authorAttribution": { "displayName": "Alex Rivera" } } ] }
الحصول على واصفات العناوين
تقدّم واصفات العناوين معلومات علائقية عن الموقع الجغرافي لمكان معيّن، بما في ذلك المعالم القريبة والمناطق المحيطة.
يوضّح المثال التالي طلب "تفاصيل المكان (جديد)" لمتجر متعدّد الأقسام
في مركز تسوّق في سان خوسيه. في هذا المثال، يمكنك تضمين 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 للحصول على تفاصيل المكان الجديد.
بالنسبة إلى الأماكن المغلقة نهائيًا، تعرض واجهة برمجة التطبيقات Place Details (New) القيمة CLOSED_PERMANENTLY في الحقل businessStatus وتحذف الحقلَين movedPlace وmovedPlaceId في نص الاستجابة.
بالنسبة إلى الأماكن التي انتقلت إلى موقع جغرافي جديد، تعرض واجهة برمجة التطبيقات Place Details (New) القيمة CLOSED_PERMANENTLY في الحقل businessStatus وتعرض الموقع الجغرافي الجديد في الحقلَين movedPlace وmovedPlaceId في نص الاستجابة.
بالنسبة إلى الأماكن التي لم يتم نقلها، لا تعرض واجهة برمجة التطبيقات Place Details (New) الحقلَين 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 } }
الحصول على معلومات عن محطات النقل العام
يمكنك استخدام تفاصيل المكان (جديد) للحصول على معلومات عن محطات النقل العام. يتضمّن نص الاستجابة معلومات عن المحطة، بما في ذلك اسم المحطة ومؤسسات النقل العام التابعة لها وخطوط النقل العام التي تخدم المحطة. بالإضافة إلى ذلك، تتضمّن الاستجابة رمز مركبة وألوانًا يمكنك استخدامها لعرض معلومات محطة النقل العام.
يعرض المثال التالي طلبًا للحصول على معلومات محطة النقل العام في محطة Grand Central:
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. يمكنك تمرير هذا الرمز المميّز إلى حزمة تطوير البرامج (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"] }, ... ] }
جرِّبها الآن.
يتيح لك "مستكشف واجهات برمجة التطبيقات" إرسال نماذج طلبات لكي تتمكّن من التعرّف على واجهة برمجة التطبيقات وخياراتها.
انقر على رمز واجهة برمجة التطبيقات api على يسار الصفحة.
يمكنك تعديل مَعلمات الطلب إذا أردت.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز ملء الشاشة ملء الشاشة لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".