Places Service

فئة PlacesService

google.maps.places.PlacesService صف

يحتوي على طرق ذات صلة بالبحث عن الأماكن واسترداد تفاصيل حول مكان معيّن.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {PlacesService} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.
PlacesService
PlacesService(attrContainer)
المَعلمات: 
تنشئ هذه الدالة مثيلاً جديدًا من PlacesService يعرض بيانات تحديد المصدر في الحاوية المحدّدة.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
المَعلمات: 
القيمة المعروضة:  لا شيء
تعرض هذه الطريقة قائمة بالأماكن استنادًا إلى رقم هاتف. في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، قد يتم عرض أكثر من نتيجة واحدة. إنّ PlaceResults التي تم تمريرها إلى دالة معاودة الاتصال هي مجموعات فرعية من PlaceResult كامل. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان من خلال طلب PlacesService.getDetails وتمرير PlaceResult.place_id للمكان المطلوب.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
المَعلمات: 
القيمة المعروضة:  لا شيء
تعرض هذه الطريقة قائمة بالأماكن استنادًا إلى سلسلة طلب بحث. في معظم الحالات، يجب أن يكون هناك عنصر واحد فقط في قائمة النتائج، ولكن إذا كان الطلب غامضًا، قد يتم عرض أكثر من نتيجة واحدة. إنّ PlaceResults التي تم تمريرها إلى دالة معاودة الاتصال هي مجموعات فرعية من PlaceResult كامل. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان من خلال طلب PlacesService.getDetails وتمرير PlaceResult.place_id للمكان المطلوب.
getDetails
getDetails(request, callback)
المَعلمات: 
القيمة المعروضة:  لا شيء
تسترد هذه الطريقة تفاصيل حول المكان الذي تم تحديده باستخدام placeId المحدّد.
nearbySearch
nearbySearch(request, callback)
المَعلمات: 
القيمة المعروضة:  لا شيء
تعرض هذه الطريقة قائمة بالأماكن القريبة من موقع جغرافي معيّن، استنادًا إلى الكلمة الرئيسية أو النوع. يجب تحديد الموقع الجغرافي دائمًا، إما عن طريق تمرير LatLngBounds أو المَعلمتَين location وradius. إنّ PlaceResults التي تم تمريرها إلى دالة الاستدعاء هي مجموعات فرعية من PlaceResult الكاملة. يمكن لتطبيقك الحصول على PlaceResult أكثر تفصيلاً لكل مكان من خلال إرسال طلب تفاصيل المكان مع تمرير PlaceResult.place_id للمكان المطلوب. يمكن استخدام العنصر PlaceSearchPagination لجلب صفحات إضافية من النتائج (تكون القيمة فارغة إذا كانت هذه آخر صفحة من النتائج أو إذا كانت هناك صفحة واحدة فقط من النتائج).
textSearch
textSearch(request, callback)
المَعلمات: 
القيمة المعروضة:  لا شيء
تعرض هذه الطريقة قائمة بالأماكن استنادًا إلى سلسلة طلب بحث (مثلاً، "بيتزا في القاهرة" أو "محلات أحذية بالقرب من الرياض"). معلَمات الموقع الجغرافي اختيارية، وعند تحديد الموقع الجغرافي، تكون النتائج متحيزة فقط نحو النتائج القريبة بدلاً من أن تقتصر على الأماكن داخل المنطقة. استخدِم textSearch عندما تريد البحث عن أماكن باستخدام سلسلة عشوائية، وفي الحالات التي قد لا تريد فيها حصر نتائج البحث على موقع جغرافي معيّن. يمكن استخدام العنصر PlaceSearchPagination لجلب صفحات إضافية من النتائج (تكون القيمة فارغة إذا كانت هذه آخر صفحة من النتائج أو إذا كانت هناك صفحة واحدة فقط من النتائج).

PlaceDetailsRequest

google.maps.places.PlaceDetailsRequest interface

طلب بحث عن تفاصيل مكان سيتم إرساله إلى PlacesService.
placeId
النوع:  string
تمثّل هذه السمة رقم تعريف المكان الذي يتم طلب تفاصيله.
fields optional
النوع:  Array<string> optional
الحقول التي سيتم تضمينها في ردّ التفاصيل، والتي سيتم تحصيل رسوم مقابلها في حال عدم تحديد أي حقول أو إدخال ['ALL']، سيتم عرض جميع الحقول المتاحة وسيتم تحصيل رسوم مقابلها (لا يُنصح بذلك في عمليات النشر في بيئة الإنتاج). للاطّلاع على قائمة بالحقول، يُرجى الانتقال إلى PlaceResult. يمكن تحديد الحقول المتداخلة باستخدام مسارات النقاط (على سبيل المثال، "geometry.location").
language optional
النوع:  string optional
معرّف اللغة التي يجب عرض التفاصيل بها اطّلِع على قائمة اللغات المتاحة.
region optional
النوع:  string optional
رمز المنطقة التي يقيم فيها المستخدم ويمكن أن يؤثر ذلك في الصور التي قد يتم عرضها، وربما في أمور أخرى. يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") مكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD الخاص بالمملكة المتحدة هو "uk" (.co.uk)، بينما رمز ISO 3166-1 هو "gb" (وهو يشير من الناحية الفنية إلى "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
sessionToken optional
النوع:  AutocompleteSessionToken optional
معرّف فريد يُستخدَم لتجميع طلب التفاصيل مع جلسة إكمال تلقائي.

FindPlaceFromPhoneNumberRequest interface

google.maps.places.FindPlaceFromPhoneNumberRequest interface

طلب البحث عن مكان من خلال البحث النصي سيتم إرساله إلى PlacesService.findPlaceFromPhoneNumber.
fields
النوع:  Array<string>
الحقول التي سيتم تضمينها في الرد، والتي سيتم تحصيل رسوم مقابلها في حال إدخال ['ALL']، سيتم عرض جميع الحقول المتاحة وسيتم تحصيل رسوم مقابلها (لا يُنصح بهذا الإجراء في عمليات النشر في مرحلة الإنتاج). للاطّلاع على قائمة بالحقول، يُرجى الانتقال إلى PlaceResult. يمكن تحديد الحقول المتداخلة باستخدام مسارات النقاط (على سبيل المثال، "geometry.location").
phoneNumber
النوع:  string
رقم هاتف المكان المطلوب البحث عنه يجب أن يكون التنسيق E.164.
language optional
النوع:  string optional
معرّف اللغة التي يجب عرض الأسماء والعناوين بها، إذا كان ذلك ممكنًا اطّلِع على قائمة اللغات المتاحة.
locationBias optional
النوع:  LocationBias optional
الانحياز المستخدَم عند البحث عن "مكان". ستكون النتيجة متحيزة نحو LocationBias المحدّد، ولكن لن تقتصر عليه.

FindPlaceFromQueryRequest interface

google.maps.places.FindPlaceFromQueryRequest interface

طلب البحث عن مكان من خلال البحث النصي سيتم إرساله إلى PlacesService.findPlaceFromQuery.
fields
النوع:  Array<string>
الحقول التي سيتم تضمينها في الرد، والتي سيتم تحصيل رسوم مقابلها في حال إدخال ['ALL']، سيتم عرض جميع الحقول المتاحة وسيتم تحصيل رسوم مقابلها (لا يُنصح بهذا الإجراء في عمليات النشر في مرحلة الإنتاج). للاطّلاع على قائمة بالحقول، يُرجى الانتقال إلى PlaceResult. يمكن تحديد الحقول المتداخلة باستخدام مسارات النقاط (على سبيل المثال، "geometry.location").
query
النوع:  string
استعلام الطلب على سبيل المثال، اسم مكان أو عنوانه
language optional
النوع:  string optional
معرّف اللغة التي يجب عرض الأسماء والعناوين بها، إذا كان ذلك ممكنًا اطّلِع على قائمة اللغات المتاحة.
locationBias optional
النوع:  LocationBias optional
الانحياز المستخدَم عند البحث عن "مكان". ستكون النتيجة متحيزة نحو LocationBias المحدّد، ولكن لن تقتصر عليه.

PlaceSearchRequest interface

google.maps.places.PlaceSearchRequest interface

طلب بحث عن مكان سيتم إرساله إلى 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، إذا تم تحديدها.
name optional
النوع:  string optional
هذا الرمز مكافئ للرمز keyword. يتم دمج القيم في هذا الحقل مع القيم في الحقل keyword ويتم تمريرها كجزء من سلسلة البحث نفسها.
openNow optional
النوع:  boolean optional
يحصر النتائج بالأماكن المفتوحة في الوقت الحالي فقط.
radius optional
النوع:  number optional
المسافة من الموقع الجغرافي المحدّد التي سيتم البحث عن "أماكن" ضمنها، وذلك بالمتر الحد الأقصى المسموح به هو 50,000.
rankBy optional
النوع: