فئة PlaceService
google.maps.places.PlacesService
الصف الدراسي
تحتوي على طرق ذات صلة بالبحث عن الأماكن واسترداد تفاصيل حول المكان.
تحميل باستخدام معلمة عنوان URL &libraries=places
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {PlacesService} = await google.map.importLibrary("places")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الشركة المصنِّعة | |
---|---|
PlacesService |
PlacesService(attrContainer) المعلّمات:
لإنشاء مثيل جديد من PlacesService يعرض الإحالات في الحاوية المحددة. |
الطُرق | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) المعلّمات:
قيمة الإرجاع: بدون
لاسترداد قائمة الأماكن بناءً على رقم الهاتف. في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، فقد يتم عرض أكثر من نتيجة واحدة. PlaceResult التي يتم تمريرها إلى معاودة الاتصال هي مجموعات فرعية من PlaceResult كامل. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان عن طريق الاتصال بـ PlacesService.getDetails وتمرير PlaceResult.place_id للمكان المطلوب. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) المعلّمات:
قيمة الإرجاع: بدون
لاسترداد قائمة الأماكن بناءً على سلسلة طلب بحث. في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، فقد يتم عرض أكثر من نتيجة واحدة. PlaceResult التي يتم تمريرها إلى معاودة الاتصال هي مجموعات فرعية من PlaceResult كامل. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان عن طريق الاتصال بـ PlacesService.getDetails وتمرير PlaceResult.place_id للمكان المطلوب. |
getDetails |
getDetails(request, callback) المعلّمات:
قيمة الإرجاع: بدون
لاسترداد تفاصيل حول المكان المحدد بواسطة placeId المحددة. |
nearbySearch |
nearbySearch(request, callback) المعلّمات:
قيمة الإرجاع: بدون
لاسترداد قائمة الأماكن بالقرب من موقع معين، استنادًا إلى الكلمة الرئيسية أو النوع. يجب دائمًا تحديد الموقع الجغرافي، إما عن طريق تمرير معلَمتَي LatLngBounds أو location وradius . PlaceResult التي يتم تمريرها إلى معاودة الاتصال هي مجموعات فرعية من PlaceResult بالكامل. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان من خلال إرسال طلب تفاصيل المكان مع تمرير PlaceResult.place_id للمكان المطلوب. يمكن استخدام الكائن PlaceSearchPagination لجلب صفحات إضافية من النتائج (تُعدّ هذه القيمة فارغة إذا كانت هذه هي الصفحة الأخيرة من النتائج أو إذا كانت هناك صفحة واحدة فقط من النتائج). |
textSearch |
textSearch(request, callback) المعلّمات:
قيمة الإرجاع: بدون
لاسترداد قائمة الأماكن بناءً على سلسلة طلب بحث (على سبيل المثال، "كشري في القاهرة" أو "متاجر أحذية بالقرب من القاهرة"). تعتبر معلمات الموقع اختيارية؛ وعندما يتم تحديد الموقع، تكون النتائج منحازة فقط للنتائج القريبة بدلاً من قصرها على الأماكن داخل المنطقة. استخدِم textSearch عندما تريد البحث عن أماكن باستخدام سلسلة عشوائية، وفي الحالات التي قد لا تريد فيها تقييد نتائج البحث بموقع جغرافي معيّن. يمكن استخدام الكائن PlaceSearchPagination لجلب صفحات إضافية من النتائج (تُعدّ هذه القيمة فارغة إذا كانت هذه هي الصفحة الأخيرة من النتائج أو إذا كانت هناك صفحة واحدة فقط من النتائج). |
PlaceDetailsRequest واجهة
واجهة
google.maps.places.PlaceDetailsRequest
طلب تفاصيل المكان لإرساله إلى PlacesService
.
أماكن إقامة | |
---|---|
placeId |
النوع:
string رقم تعريف المكان للمكان الذي يتم طلب التفاصيل منه. |
fields optional |
النوع:
Array<string> optional الحقول المراد تضمينها في رد التفاصيل الذي سيتم إرسال الفواتير إليه. إذا لم يتم تحديد أي حقول أو تم تمرير ['ALL'] ، سيتم إرجاع جميع الحقول المتاحة وتحصيل الرسوم بشأنها (لا يُنصَح بهذا الإجراء لعمليات نشر الإنتاج). للحصول على قائمة بالحقول، راجع PlaceResult . يمكن تحديد الحقول المتداخلة بمسارات نقطة (مثل "geometry.location" ). |
language optional |
النوع:
string optional معرّف لغة للغة التي يجب عرض التفاصيل بها. راجع قائمة اللغات المدعومة. |
region optional |
النوع:
string optional رمز منطقة المستخدم. يمكن أن يؤثر ذلك في الصور التي يمكن عرضها، وربما أشياء أخرى. يقبل رمز المنطقة قيمة من حرفين (ccTLD ("نطاق المستوى الأعلى"). تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD للمملكة المتحدة هو "uk" ( .co.uk ) بينما رمز ISO 3166-1 هو "gb" (ويُقصد به الكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية"). |
sessionToken optional |
النوع:
AutocompleteSessionToken optional مرجع فريد يُستخدم لتجميع طلب التفاصيل مع جلسة إكمال تلقائي. |
واجهة FindPlaceFromPhoneNumberRequest
واجهة
google.maps.places.FindPlaceFromPhoneNumberRequest
مكان من طلب البحث النصي لإرساله إلى PlacesService.findPlaceFromPhoneNumber
.
أماكن إقامة | |
---|---|
fields |
النوع:
Array<string> الحقول المطلوب تضمينها في الرد، والتي سيتم إرسال الفواتير إليها. في حال تمرير ['ALL'] ، سيتم إرجاع جميع الحقول المتاحة وتحصيل رسوم عنها (لا يُنصَح بهذا الإجراء لعمليات نشر الإنتاج). للحصول على قائمة بالحقول، راجع PlaceResult . يمكن تحديد الحقول المتداخلة بمسارات نقطة (مثل "geometry.location" ). |
phoneNumber |
النوع:
string رقم هاتف المكان المطلوب البحث عنه. يجب أن يكون التنسيق E.164. |
language optional |
النوع:
string optional معرّف لغة للغة التي يجب عرض الأسماء والعناوين بها، إن أمكن. راجع قائمة اللغات المدعومة. |
locationBias optional |
النوع:
LocationBias optional الانحياز المستخدم عند البحث عن المكان. سيتم انحياز النتيجة نحو، على سبيل المثال لا الحصر، LocationBias المحدد. |
واجهة FindPlaceFromQueryRequest
واجهة
google.maps.places.FindPlaceFromQueryRequest
مكان من طلب البحث النصي لإرساله إلى PlacesService.findPlaceFromQuery
.
أماكن إقامة | |
---|---|
fields |
النوع:
Array<string> الحقول المطلوب تضمينها في الرد، والتي سيتم إرسال الفواتير إليها. في حال تمرير ['ALL'] ، سيتم إرجاع جميع الحقول المتاحة وتحصيل رسوم عنها (لا يُنصَح بهذا الإجراء لعمليات نشر الإنتاج). للحصول على قائمة بالحقول، راجع PlaceResult . يمكن تحديد الحقول المتداخلة بمسارات نقطة (مثل "geometry.location" ). |
query |
النوع:
string طلب البحث. على سبيل المثال، اسم المكان أو عنوانه. |
language optional |
النوع:
string optional معرّف لغة للغة التي يجب عرض الأسماء والعناوين بها، إن أمكن. راجع قائمة اللغات المدعومة. |
locationBias optional |
النوع:
LocationBias optional الانحياز المستخدم عند البحث عن المكان. سيتم انحياز النتيجة نحو، على سبيل المثال لا الحصر، LocationBias المحدد. |
PlaceSearchRequest واجهة
واجهة
google.maps.places.PlaceSearchRequest
طلب بحث عن مكان لإرساله إلى PlacesService
.
أماكن إقامة | |
---|---|
bounds optional |
النوع:
LatLngBounds|LatLngBoundsLiteral optional الحدود التي يتم البحث داخلها عن الأماكن. سيتم تجاهل كل من location وradius إذا تم ضبط bounds . |
keyword optional |
النوع:
string optional عبارة تتم مطابقتها مع جميع الحقول المتاحة، بما في ذلك على سبيل المثال لا الحصر، الاسم والنوع والعنوان، إلى جانب تعليقات العملاء وغير ذلك من محتوى الجهات الخارجية. |
language optional |
النوع:
string optional معرّف لغة للغة التي يجب عرض الأسماء والعناوين بها، إن أمكن. راجع قائمة اللغات المدعومة. |
location optional |
النوع:
LatLng|LatLngLiteral optional الموقع الذي تبحث حوله عن الأماكن. |
maxPriceLevel optional |
النوع:
number optional يقصر النتائج على تلك الأماكن عند مستوى السعر المحدد أو الأدنى فقط. تتراوح القيم الصالحة بين 0 (أغلى سعر) و4 (أغلى سعر) بما في ذلك القيمتين. يجب أن يكون أكبر من أو يساوي minPrice ، إذا تم تحديده. |
minPriceLevel optional |
النوع:
number optional يقصر النتائج على تلك الأماكن عند مستوى السعر المحدد أو مستوى أعلى فقط. تتراوح القيم الصالحة بين 0 (أغلى سعر) و4 (أغلى سعر) بما في ذلك القيمتين. يجب أن يكون أقل من أو يساوي maxPrice ، إذا تم تحديده. |
|
النوع:
string optional هذا الرمز مكافئ للرمز keyword . يتم دمج القيم في هذا الحقل مع القيم في الحقل keyword ويتم تمريرها كجزء من سلسلة البحث نفسها. |
openNow optional |
النوع:
boolean optional يقصر النتائج على الأماكن المفتوحة الآن فقط. |
radius optional |
النوع:
number optional المسافة من الموقع المحدد والتي يتم البحث داخلها عن الأماكن، بالأمتار. الحد الأقصى المسموح به للقيمة هو 50000. |
rankBy optional |
النوع:
RankBy optional تلقائي:
RankBy.PROMINENCE تحدّد طريقة الترتيب المطلوب استخدامها عند عرض النتائج. لاحظ أنه عند ضبط rankBy على DISTANCE ، يجب تحديد location ولكن لا يمكنك تحديد radius أو bounds . |
type optional |
النوع:
string optional للبحث عن أماكن من نوع معين. تتم ترجمة النوع إلى اللغة المحلية للموقع المستهدف للطلب واستخدامه كسلسلة طلب بحث. إذا تم أيضًا تقديم طلب بحث، يتم ربطه بسلسلة النوع المترجم. يتم إسقاط النتائج من نوع مختلف من الاستجابة. استخدم هذا الحقل لإجراء عمليات بحث فئوية مستقلة عن اللغة والمنطقة. وتتوفّر الأنواع الصالحة هنا. |
TextSearchRequest واجهة
واجهة
google.maps.places.TextSearchRequest
طلب بحث نصي لإرساله إلى PlacesService
.
أماكن إقامة | |
---|---|
bounds optional |
النوع:
LatLngBounds|LatLngBoundsLiteral optional الحدود المستخدمة للانحياز في النتائج عند البحث عن الأماكن (اختياري). سيتم تجاهل كل من location وradius إذا تم ضبط bounds . لن تقتصر النتائج على من هم داخل هذه الحدود، ولكن ستحصل النتائج بداخله على ترتيب أعلى. |
language optional |
النوع:
string optional معرّف لغة للغة التي يجب عرض الأسماء والعناوين بها، إن أمكن. راجع قائمة اللغات المدعومة. |
location optional |
النوع:
LatLng|LatLngLiteral optional هو مركز المنطقة المستخدم في الانحياز على النتائج عند البحث عن الأماكن. |
query optional |
النوع:
string optional عبارة طلب البحث للطلب. على سبيل المثال، اسم مكان ("برج خليفة")، أو فئة متبوعًا باسم موقع ("كباب في دبي")، أو اسم مكان متبوعًا بتمييز لأحد المواقع ("ستاربكس في القاهرة"). |
radius optional |
النوع:
number optional نصف قطر المنطقة المستخدم في الانحياز لنتائج عند البحث عن الأماكن بالأمتار. |
region optional |
النوع:
string optional رمز منطقة يؤدي الانحياز إلى النتائج. يقبل رمز المنطقة قيمة من حرفين (ccTLD ("نطاق المستوى الأعلى"). تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD للمملكة المتحدة هو "uk" ( .co.uk ) بينما رمز ISO 3166-1 هو "gb" (ويُقصد به الكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية"). |
type optional |
النوع:
string optional للبحث عن أماكن من نوع معين. تتم ترجمة النوع إلى اللغة المحلية للموقع المستهدف للطلب واستخدامه كسلسلة طلب بحث. إذا تم أيضًا تقديم طلب بحث، يتم ربطه بسلسلة النوع المترجم. يتم إسقاط النتائج من نوع مختلف من الاستجابة. استخدم هذا الحقل لإجراء عمليات بحث فئوية مستقلة عن اللغة والمنطقة. وتتوفّر الأنواع الصالحة هنا. |
ثواني الثوابت
google.maps.places.RankBy
ثوابت
خيارات الترتيب لـ PlaceSearchRequest.
تحميل باستخدام معلمة عنوان URL &libraries=places
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {RankBy} = await google.map.importLibrary("places")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الثوابت | |
---|---|
DISTANCE |
تضع التصنيفات النتائج بحسب المسافة من الموقع. |
PROMINENCE |
تضع الترتيبات النتائج حسب بروزها. |
LocationBias typedef
google.maps.places.LocationBias
typedef
يمثل انحياز الموقع حدًا أو إشارة مرنة للاستخدام عند البحث عن الأماكن. قد تظهر النتائج من خارج المنطقة المحدّدة. لاستخدام عنوان IP الحالي للمستخدم كانحياز، يمكن تحديد السلسلة "IP_BIAS"
. ملاحظة: في حالة استخدام Circle
، يجب تحديد المركز والنطاق الجغرافي.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
تقييد المواقع typedef
google.maps.places.LocationRestriction
typedef
يمثل تقييد الموقع حدًا صارمًا للاستخدام عند البحث عن الأماكن.
ثوابت PlaceServiceStatus
google.maps.places.PlacesServiceStatus
ثوابت
الحالة التي تعرضها علامة PlacesService
عند اكتمال عمليات البحث. حدد هذه القيم بحسب القيمة أو باستخدام اسم الثوابت. على سبيل المثال، 'OK'
أو google.maps.places.PlacesServiceStatus.OK
.
تحميل باستخدام معلمة عنوان URL &libraries=places
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {PlacesServiceStatus} = await google.map.importLibrary("places")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الثوابت | |
---|---|
INVALID_REQUEST |
هذا الطلب غير صالح. |
NOT_FOUND |
لم يتم العثور على المكان المشار إليه. |
OK |
تحتوي الاستجابة على نتيجة صالحة. |
OVER_QUERY_LIMIT |
تجاوز التطبيق حصة الطلبات. |
REQUEST_DENIED |
لا يُسمح للتطبيق باستخدام PlacesService . |
UNKNOWN_ERROR |
تعذرت معالجة الطلب PlacesService بسبب خطأ في الخادم. قد ينجح الطلب في حال إعادة المحاولة. |
ZERO_RESULTS |
لم يتم العثور على أي نتائج لهذا الطلب. |
واجهة PlaceSearchPagiting
واجهة
google.maps.places.PlaceSearchPagination
كائن يُستخدم لجلب صفحات إضافية من نتائج الأماكن.
أماكن إقامة | |
---|---|
hasNextPage |
النوع:
boolean يشير إلى ما إذا كانت هناك نتائج أخرى متاحة. true عندما تكون هناك صفحة نتائج إضافية. |
الطُرق | |
---|---|
nextPage |
nextPage() المعلّمات: بدون
قيمة الإرجاع: بدون
لجلب صفحة النتائج التالية. لاستخدام نفس دالة رد الاتصال التي تم تقديمها إلى طلب البحث الأول. |
PlaceResult واجهة
واجهة
google.maps.places.PlaceResult
لتحديد معلومات حول المكان.
أماكن إقامة | |
---|---|
address_components optional |
النوع:
Array<GeocoderAddressComponent> optional مجموعة مكونات العنوان لموقع هذا المكان. متاح فقط في PlacesService.getDetails . |
adr_address optional |
النوع:
string optional تمثيل عنوان المكان في adr microformat متاح فقط في PlacesService.getDetails . |
aspects optional |
النوع:
Array<PlaceAspectRating> optional الجوانب التي تم تقييمها لهذا المكان، استنادًا إلى تعليقات مستخدمي Google وZagat. تكون التقييمات على مقياس من 0 إلى 30. |
business_status optional |
النوع:
BusinessStatus optional علامة تشير إلى الحالة التشغيلية للمكان، إذا كان النشاط التجاري (يشير إلى ما إذا كان المكان يعمل أو مغلقًا بشكل مؤقت أو دائم). في حال عدم توفّر أي بيانات، يعني ذلك أنّ العلامة غير متوفّرة في البحث أو الردود على التفاصيل. |
formatted_address optional |
النوع:
string optional عنوان المكان بالكامل. |
formatted_phone_number optional |
النوع:
string optional رقم هاتف المكان، مُنسَّق وفقًا للاتفاقية الإقليمية للرقم. متاح فقط في PlacesService.getDetails . |
geometry optional |
النوع:
PlaceGeometry optional المعلومات المتعلقة بالأشكال الهندسية في المكان. |
html_attributions optional |
النوع:
Array<string> optional نص الإحالة الذي سيتم عرضه لنتيجة المكان هذه. يتم دائمًا إرجاع html_attributions المتاح بغض النظر عن ما تم طلبه بواسطة fields ، ويجب عرضه. |
icon optional |
النوع:
string optional عنوان URL لمورد صورة يمكن استخدامه لتمثيل فئة هذا المكان. |
icon_background_color optional |
النوع:
string optional لون الخلفية للاستخدام مع رمز المكان. يمكنك الاطّلاع أيضًا على PlaceResult.icon_mask_base_uri . |
icon_mask_base_uri optional |
النوع:
string optional عنوان URL مقطوع لقناع رمز. يمكنك الوصول إلى أنواع رموز مختلفة من خلال إلحاق امتداد ملف بالنهاية (أي .svg أو .png ). |
international_phone_number optional |
النوع:
string optional رقم هاتف المكان بالتنسيق الدولي. يتضمن التنسيق الدولي رمز البلد، مسبوقًا بالعلامة (+). متاح فقط في PlacesService.getDetails . |
name optional |
النوع:
string optional اسم المكان. ملاحظة: في حالة إدخال المستخدم لأماكن، هذا هو النص الأولي، كما كتبه المستخدم. الرجاء توخي الحذر عند استخدام هذه البيانات، حيث قد يحاول المستخدمون الضارون استخدامها كدليل لهجمات إدخال الشفرة (راجع http://en.wikipedia.org/wiki/Code_injection). |
opening_hours optional |
النوع:
PlaceOpeningHours optional لتحديد وقت فتح المكان أو إغلاقه. |
|
النوع:
boolean optional علامة تشير إلى ما إذا كان المكان مغلقًا، إما بشكل دائم أو مؤقت. إذا كان المكان يعمل، أو إذا لم تكن هناك بيانات متاحة، فلن تظهر العلامة في الاستجابة. |
photos optional |
النوع:
Array<PlacePhoto> optional صور لهذا المكان. ستتضمّن المجموعة ما يصل إلى عشرة كائنات PlacePhoto . |
place_id optional |
النوع:
string optional معرّف فريد للمكان. |
plus_code optional |
النوع:
PlacePlusCode optional تحدد "رموز المواقع المفتوحة" أو "رموز المواقع المفتوحة" للمكان. |
price_level optional |
النوع:
number optional مستوى سعر المكان على مقياس من 0 إلى 4. يتم تفسير مستويات الأسعار على النحو التالي:
|
rating optional |
النوع:
number optional تقييم ما بين 1.0 و5.0، استنادًا إلى تعليقات المستخدمين عن هذا المكان. |
reviews optional |
النوع:
Array<PlaceReview> optional قائمة بالتعليقات حول هذا المكان. متاح فقط في PlacesService.getDetails . |
types optional |
النوع:
Array<string> optional مصفوفة من أنواع لهذا المكان (على سبيل المثال، ["political", "locality"] أو ["restaurant", "establishment"] ). |
url optional |
النوع:
string optional عنوان URL لصفحة Google الرسمية لهذا المكان. هذه هي الصفحة التي تملكها Google وتحتوي على أفضل المعلومات المتوفرة حول المكان. متاح فقط في PlacesService.getDetails . |
user_ratings_total optional |
النوع:
number optional عدد تقييمات المستخدمين التي ساهمت في PlaceResult.rating لهذا المكان. |
|
النوع:
number optional الفرق من التوقيت العالمي المنسق (UTC) من المنطقة الزمنية الحالية للمكان بالدقائق. على سبيل المثال، توقيت سيدني الصيفي في أستراليا يسبق التوقيت الصيفي بـ 11 ساعة، وبالتالي فإن utc_offset سيكون 660 . بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسق (UTC)، تكون الإزاحة سالبة. على سبيل المثال، utc_offset هو -60 للرأس الأخضر. متاح فقط في PlacesService.getDetails . |
utc_offset_minutes optional |
النوع:
number optional الفرق من التوقيت العالمي المنسق (UTC) من المنطقة الزمنية الحالية للمكان بالدقائق. على سبيل المثال، توقيت سيدني الصيفي في أستراليا يسبق التوقيت الصيفي بـ 11 ساعة، وبالتالي فإن utc_offset_minutes سيكون 660 . بالنسبة إلى المناطق الزمنية وراء التوقيت العالمي المنسق (UTC)، تكون الإزاحة سالبة. على سبيل المثال، utc_offset_minutes هو -60 للرأس الأخضر. متاح فقط في PlacesService.getDetails . |
vicinity optional |
النوع:
string optional العنوان المبسّط للمكان، بما في ذلك اسم الشارع ورقم الشارع والمنطقة المحلية، وليس المقاطعة/الولاية أو الرمز البريدي أو البلد. على سبيل المثال، يقع مقر مكتب Google في مدينة سيدني بأستراليا بقيمة "48 Pirrama Road, Pyrmont" . متاح فقط في PlacesService.getDetails . |
website optional |
النوع:
string optional موقع الويب الموثوق لهذا المكان، مثل الصفحة الرئيسية للنشاط التجاري. متاح فقط في PlacesService.getDetails . |
PlaceAspectRating واجهة
واجهة
google.maps.places.PlaceAspectRating
تحدّد هذه السمة معلومات عن جانب من الأماكن راجعها المستخدمون.
أماكن إقامة | |
---|---|
rating |
النوع:
number تمثل هذه الخاصية تقييم هذا الجانب. وبالنسبة إلى المراجعات الفردية، يكون هذا العدد صحيحًا من 0 إلى 3. بالنسبة إلى التقييمات المجمَّعة لأحد الأماكن، يكون هذا العدد صحيحًا من 0 إلى 30. |
type |
النوع:
string نوع العرض. على سبيل المثال، "food" أو "decor" أو "service" أو "overall" . |
BusinessStatus الثوابت
google.maps.places.BusinessStatus
ثوابت
حالة تشغيل المكان، إذا كان نشاطًا تجاريًا، يتم عرضه في نتيجة المكان (يشير إلى ما إذا كان المكان يعمل أو مغلقًا بشكل مؤقت أو دائم). ويمكنك تحديد هذه القيم حسب القيمة أو اسم الثوابت (على سبيل المثال: 'OPERATIONAL'
أو google.maps.places.BusinessStatus.OPERATIONAL
).
تحميل باستخدام معلمة عنوان URL &libraries=places
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
عند استخدام v=beta
، يمكن الوصول إليه من خلال الاتصال بـ const {BusinessStatus} = await google.map.importLibrary("places")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الثوابت | |
---|---|
CLOSED_PERMANENTLY |
النشاط التجاري مغلق نهائيًا. |
CLOSED_TEMPORARILY |
النشاط التجاري مغلق مؤقتًا. |
OPERATIONAL |
النشاط التجاري يعمل بشكل طبيعي. |
واجهة GeoGeo الواجهة
واجهة
google.maps.places.PlaceGeometry
لتعريف معلومات حول هندسة المكان.
أماكن إقامة | |
---|---|
location optional |
النوع:
LatLng optional تمثل هذه الخاصية موضع المكان. |
viewport optional |
النوع:
LatLngBounds optional إطار العرض المفضل عند عرض هذا المكان على الخريطة. ستكون هذه الخاصية null إذا كان إطار العرض المفضل للمكان غير معروف. متاح فقط في PlacesService.getDetails . |
واجهة PlaceOpeningHours
واجهة
google.maps.places.PlaceOpeningHours
لتحديد معلومات حول ساعات العمل في المكان.
أماكن إقامة | |
---|---|
|
النوع:
boolean optional ما إذا كان المكان مفتوحًا في الوقت الحالي أم لا. |
periods optional |
النوع:
Array<PlaceOpeningHoursPeriod> optional فترات الافتتاح تغطي كل يوم من أيام الأسبوع، بدءًا من يوم الأحد، بترتيب زمني. ولا يتم تضمين الأيام التي لا يكون المكان فيها مفتوحًا. متاح فقط في PlacesService.getDetails . |
weekday_text optional |
النوع:
Array<string> optional مصفوفة من سبعة سلاسل تمثل ساعات العمل المنسقة لكل يوم من أيام الأسبوع. ستعمل خدمة الأماكن على تنسيق ساعات العمل وأقلمتها بشكل مناسب للغة الحالية. ويعتمد ترتيب العناصر في هذه المصفوفة على اللغة. تبدأ بعض اللغات الأسبوع من الإثنين، بينما تبدأ بعض اللغات الأخرى من يوم الأحد. متاح فقط في PlacesService.getDetails . وقد تعرض المكالمات الأخرى صفيفًا فارغًا. |
الطُرق | |
---|---|
isOpen |
isOpen([date]) المعلّمات:
قيمة الإرجاع:
boolean|undefined تحقق مما إذا كان المكان مفتوحًا الآن (في حالة عدم مرور تاريخ)، أو في التاريخ المحدد. إذا كان هذا المكان لا يحتوي على PlaceResult.utc_offset_minutes أو PlaceOpeningHours.periods ، يتم عرض undefined (لا يتوفر PlaceOpeningHours.periods إلا عبر PlacesService.getDetails ). ولا تعتمد هذه الطريقة ساعات العمل الاستثنائية، مثل ساعات العمل خلال العطلات. |
واجهة PlaceOpeningHoursPeriod
واجهة
google.maps.places.PlaceOpeningHoursPeriod
لتحديد المعلومات المنظمة حول ساعات العمل في المكان. ملاحظة: إذا كان أحد الأماكن مفتوحًا دائمًا، لن يظهر قسم close
في الرد. يمكن أن يعتمد العملاء على التمثيل دائمًا كفترة open
التي تحتوي على day
بالقيمة 0
وtime
بالقيمة "0000"
وليس close
.
أماكن إقامة | |
---|---|
open |
النوع:
PlaceOpeningHoursTime تمثّل هذه الخاصية وقت فتح المكان. |
close optional |
النوع:
PlaceOpeningHoursTime optional تمثل هذه الخاصية وقت إغلاق المكان. |
واجهة PlaceOpeningHoursTime
واجهة
google.maps.places.PlaceOpeningHoursTime
لتحديد وقت فتح المكان أو إغلاقه.
أماكن إقامة | |
---|---|
day |
النوع:
number أيام الأسبوع، كرقم في النطاق [ 0 ، 6 ]، بدءًا من يوم الأحد. على سبيل المثال، 2 تعني الثلاثاء. |
hours |
النوع:
number ساعات PlaceOpeningHoursTime.time كرقم، في النطاق [0 ، 23 ]. سيتم الإبلاغ عن ذلك في المنطقة الزمنية للمكان. |
minutes |
النوع:
number دقائق PlaceOpeningHoursTime.time كرقم، في النطاق [0 ، 59 ]. سيتم الإبلاغ عن ذلك في المنطقة الزمنية للمكان. |
time |
النوع:
string تمثل هذه الخاصية الوقت من اليوم بتنسيق "25 ساعة". تقع القيم في النطاق [ "0000" ، "2359" ]. سيتم الإبلاغ عن الوقت في المنطقة الزمنية للمكان. |
nextDate optional |
النوع:
number optional الطابع الزمني (بالمللي ثانية منذ البداية، مناسب للاستخدام مع new Date() ) الذي يمثل الورود التالي لـ PlaceOpeningHoursTime. ويتم احتسابها من PlaceOpeningHoursTime.day من الأسبوع، وPlaceOpeningHoursTime.time ، وPlaceResult.utc_offset_minutes . إذا كانت قيمة PlaceResult.utc_offset_minutes هي undefined ، ستكون قيمة nextDate هي undefined . |
واجهة PlacePlusCode
واجهة
google.maps.places.PlacePlusCode
لتحديد "رموز المواقع المفتوحة" أو "رموز المواقع المفتوحة" لمكان ما. يمكن استخدام رموز المواقع المفتوحة كبديل لعناوين الشوارع في الأماكن التي لا توجد فيها (حيث لا تكون المباني مرقمة أو لا يتم تسمية الشوارع).
أماكن إقامة | |
---|---|
global_code |
النوع:
string رمز علامة الجمع الذي يتضمّن درجة 1/8000 من الدرجة 1/8000 من مساحة الدرجة. مثلاً: "8FVC9G8F+5W" |
compound_code optional |
النوع:
string optional رمز علامة زائد بزاوية 1/8000 من الدرجة 1/8000 من مساحة درجة حيث يتم تجاهل الأحرف الأربعة الأولى (رمز المنطقة) واستبدالها بوصف محلي. مثلاً: "9G8F+5W Zurich, Switzerland" إذا لم تكن هناك منطقة محلية مناسبة يمكن العثور عليها لتقصير الشفرة، فسيتم حذف هذا الحقل. |
واجهة PlacePhoto
واجهة
google.maps.places.PlacePhoto
يمثل عنصر صورة للمكان.
أماكن إقامة | |
---|---|
height |
النوع:
number ارتفاع الصورة بالبكسل. |
html_attributions |
النوع:
Array<string> نص الإحالة الذي سيتم عرضه لهذه الصورة. |
width |
النوع:
number عرض الصورة بالبكسل. |
الطُرق | |
---|---|
getUrl |
getUrl([opts]) المعلّمات:
قيمة الإرجاع:
string لعرض عنوان URL للصورة المقابل للخيارات المحددة. |
PhotoOptions واجهة
واجهة
google.maps.places.PhotoOptions
لتحديد خيارات طلب الصور.
أماكن إقامة | |
---|---|
maxHeight optional |
النوع:
number optional الحد الأقصى للارتفاع بوحدات البكسل للصورة المعروضة. |
maxWidth optional |
النوع:
number optional الحد الأقصى للعرض بوحدات البكسل للصورة المعروضة. |
PlaceReview واجهة
واجهة
google.maps.places.PlaceReview
يمثل مراجعة واحدة لمكان.
أماكن إقامة | |
---|---|
author_name |
النوع:
string اسم المراجع. |
language |
النوع:
string رمز لغة IETF يشير إلى اللغة التي تمت كتابة هذه المراجعة بها. لاحظ أن هذا الرمز لا يتضمن سوى علامة اللغة الرئيسية فقط بدون أي علامة ثانوية تشير إلى البلد أو المنطقة. على سبيل المثال، تم وضع علامة 'en' على جميع المراجعات المكتوبة باللغة الإنجليزية بدلاً من "en-AU" أو "en-UK". |
profile_photo_url |
النوع:
string تمثّل هذه السمة عنوان URL لصورة الملف الشخصي للمسؤول. |
relative_time_description |
النوع:
string تمثّل هذه الخاصية سلسلة من الوقت الحالي المنسّق، وتعبّر عن وقت المراجعة بالوقت الحالي في نموذج مناسب للغة والبلد. على سبيل المثال "a month ago" . |
text |
النوع:
string نص المراجعة. |
time |
النوع:
number الطابع الزمني للمراجعة، معبرًا عنه بالثواني منذ البداية. |
|
النوع:
Array<PlaceAspectRating> optional الجوانب التي قيّمتها المراجعة. التقييمات على مقياس من 0 إلى 3. |
author_url optional |
النوع:
string optional عنوان URL يؤدي إلى الملف الشخصي للمراجع. سيكون هذا undefined عندما يكون الملف الشخصي للمراجع غير متاح. |
rating optional |
النوع:
number optional تمثل هذه الخاصية تقييم هذه المراجعة، وهو عدد يتراوح من 1.0 إلى 5.0 (شامل). |