تتيح لك خدمة بحث في الجوار (الإصدار القديم) البحث عن أماكن ضمن منطقة محدّدة. يمكنك تحسين طلب البحث من خلال تقديم كلمات رئيسية أو تحديد نوع المكان الذي تبحث عنه.
طلبات "البحث في الجوار" (الإصدار القديم)
طلب بحث في الجوار (الإصدار القديم) هو عنوان URL يستخدم HTTP بالشكل التالي:
https://maps.googleapis.com/maps/api/place/nearbysearch/output?parameters
حيث يمكن أن تكون output إحدى القيمتين التاليتين:
-
json(موصى به) يشير إلى الإخراج بتنسيق JavaScript Object Notation (JSON) - تشير
xmlإلى أنّ الناتج بتنسيق XML
يجب توفُّر مَعلمات معيّنة لبدء طلب "بحث في الجوار (الإصدار القديم)". وكما هو معتاد في عناوين URL، يتم الفصل بين جميع المَعلمات باستخدام رمز العطف اللاتيني (&).
المعلمات المطلوبة
-
الموقع
النقطة التي سيتم استرداد معلومات المكان حولها. يجب تحديدها على أنّها
latitude,longitude. -
نطاق جغرافي
تحدّد هذه السمة المسافة (بالمتر) التي يجب أن تظهر ضمنها نتائج الأماكن. يمكنك تحسين النتائج لتناسب دائرة محدّدة من خلال تمرير المَعلمتَين
locationوradius. سيؤدي ذلك إلى توجيه خدمة "الأماكن" إلى تفضيل عرض النتائج ضمن تلك الدائرة، ولكن قد يستمر عرض النتائج خارج المنطقة المحدّدة.سيتم تلقائيًا حصر نصف القطر بقيمة قصوى استنادًا إلى نوع البحث والمَعلمات الأخرى.
- الإكمال التلقائي: 50,000 متر
-
البحث في الجوار:
- مع
keywordأوname: 50,000 متر -
بدون
keywordأوname-
ما يصل إلى 50,000 متر، يتم تعديلها ديناميكيًا استنادًا إلى كثافة المنطقة، بغض النظر عن المَعلمة
rankby. -
عند استخدام
rankby=distance، لن يتم قبول مَعلمة نصف القطر، وسيؤدي ذلك إلى ظهورINVALID_REQUEST.
-
ما يصل إلى 50,000 متر، يتم تعديلها ديناميكيًا استنادًا إلى كثافة المنطقة، بغض النظر عن المَعلمة
- مع
- ميزة "الإكمال التلقائي للبحث": 50,000 متر
- البحث النصي: 50,000 متر
المعلمات الاختيارية
-
كلمة رئيسية
سلسلة النص المطلوب البحث فيها، على سبيل المثال: "مطعم" أو "123 شارع رئيسي". يجب أن يكون اسم مكان أو عنوانًا أو فئة من المؤسسات. يمكن أن تؤدي أي أنواع أخرى من الإدخالات إلى حدوث أخطاء، ولا نضمن عرض نتائج صالحة. ستعرض خدمة Google Places نتائج مطابقة محتملة استنادًا إلى هذه السلسلة، كما سترتّب النتائج حسب مدى صلتها بالموضوع.
قد يؤدي تضمين معلومات الموقع الجغرافي بشكل صريح باستخدام هذه المَعلمة إلى حدوث تعارض مع المَعلمات location وradius وrankby، ما يتسبّب في ظهور نتائج غير متوقّعة.
في حال حذف هذه المَعلمة، لن يتم عرض الأماكن التي تكون فيها قيمة business_status هي CLOSED_TEMPORARILY أو CLOSED_PERMANENTLY.
-
language
اللغة التي سيتم عرض النتائج بها
- اطّلِع على قائمة اللغات المتاحة. يُجري محرّك بحث Google تحديثات على اللغات المتوافقة بشكل متكرر، لذا قد لا تكون هذه القائمة شاملة.
-
في حال عدم توفير
language، تحاول واجهة برمجة التطبيقات استخدام اللغة المفضّلة كما هو محدّد في عنوانAccept-Language. - تبذل واجهة برمجة التطبيقات قصارى جهدها لتقديم عنوان شارع يمكن قراءته من قِبل المستخدمين والسكان المحليين. لتحقيق هذا الهدف، تعرض الخدمة عناوين الشوارع باللغة المحلية، مع ترجمتها إلى نص يمكن للمستخدم قراءته إذا لزم الأمر، مع مراعاة اللغة المفضّلة. ويتم عرض جميع العناوين الأخرى باللغة المفضّلة. يتم عرض جميع مكونات العنوان باللغة نفسها، والتي يتم اختيارها من المكون الأول.
- إذا لم يتوفّر اسم باللغة المفضّلة، تستخدم واجهة برمجة التطبيقات أقرب نتيجة مطابِقة.
- للغة المفضّلة تأثير بسيط على مجموعة النتائج التي تختار واجهة برمجة التطبيقات عرضها، وعلى ترتيب عرضها. يفسّر برنامج الترميز الجغرافي الاختصارات بشكل مختلف حسب اللغة، مثل اختصارات أنواع الشوارع أو المرادفات التي قد تكون صالحة في لغة ما ولكن ليس في لغة أخرى. على سبيل المثال، utca وtér هما كلمتان مترادفتان لكلمة "شارع" باللغة الهنغارية.
-
maxprice
لحصر النتائج على الأماكن الواقعة ضمن النطاق المحدّد فقط تتراوح القيم الصالحة بين 0 (الأكثر توفيرًا) و4 (الأكثر تكلفةً)، شاملةً القيمتين. سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى.
-
minprice
لحصر النتائج على الأماكن الواقعة ضمن النطاق المحدّد فقط تتراوح القيم الصالحة بين 0 (الأكثر توفيرًا) و4 (الأكثر تكلفةً)، شاملةً القيمتين. سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى.
-
الاسم
تم إيقافهذا الرمز مكافئ للرمز
keyword. يتم دمج القيم في هذا الحقل مع القيم في الحقلkeywordوتمريرها كجزء من سلسلة البحث نفسها. -
opennow
لا تعرض سوى الأماكن المفتوحة عند إرسال طلب البحث. لن يتم عرض الأماكن التي لا تحدّد ساعات العمل في قاعدة بيانات Google Places إذا تضمّنت هذه المَعلمة في طلب البحث.
-
pagetoken
تعرض هذه الطريقة ما يصل إلى 20 نتيجة من عملية بحث تم إجراؤها سابقًا. سيؤدي ضبط المَعلمة
pagetokenإلى تنفيذ عملية بحث باستخدام المَعلمات نفسها التي تم استخدامها سابقًا، وسيتم تجاهل جميع المَعلمات الأخرى باستثناء pagetoken. -
rankby
تحدّد هذه السمة ترتيب عرض النتائج. القيم المحتملة هي:
-
prominence(تلقائي) يرتّب هذا الخيار النتائج حسب أهميتها. سيعطي الترتيب الأولوية للأماكن البارزة ضمن النطاق الجغرافي المحدّد على الأماكن المجاورة التي تتطابق مع معايير البحث ولكنها أقل بروزًا. يمكن أن تتأثر أهمية المكان بترتيبه في فهرس Google، وبمعدّل الإقبال عليه على مستوى العالم، وبعوامل أخرى. عند تحديد مستوى الظهور، يجب توفير المَعلمةradius. -
distance. يؤدي هذا الخيار إلى تحيز نتائج البحث بترتيب تصاعدي حسب المسافة بينها وبين الموقع الجغرافي المحدّد. عند تحديدdistance، يجب تحديد قيمة واحدة أو أكثر من القيمkeywordأوnameأوtype، ولا يُسمح باستخدامradius.
-
-
النوع
لحصر النتائج على الأماكن التي تتطابق مع النوع المحدّد. يمكن تحديد نوع واحد فقط. في حال تقديم أكثر من نوع واحد، سيتم تجاهل جميع الأنواع التي تلي الإدخال الأول.
-
تصبح قيمة
type=hospital|pharmacy|doctortype=hospital - يتم تجاهل
type=hospital,pharmacy,doctorبالكامل
اطّلِع على قائمة الأنواع المتوافقة.
ملاحظة: يمكن أن يؤدي إضافة كل منkeywordوtypeبالقيمة نفسها (keyword=cafe&type=cafeأوkeyword=parking&type=parking) إلى ظهورZERO_RESULTS. -
تصبح قيمة
مثال على "البحث في الجوار" (الإصدار القديم)
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/nearbysearch/json ?keyword=cruise &location=-33.8670522%2C151.1957362 &radius=1500 &type=restaurant &key=YOUR_API_KEY
ملاحظة: في هذا المثال، عليك استبدال key
بمفتاح واجهة برمجة التطبيقات الخاص بك لكي يعمل الطلب في تطبيقك.
ردود "البحث في الجوار" (الإصدار القديم)
يعرض المثال التالي استجابة بحث في الجوار (إصدار قديم).
JSON
{ "html_attributions": [], "results": [ { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8587323, "lng": 151.2100055 }, "viewport": { "northeast": { "lat": -33.85739847010727, "lng": 151.2112436298927 }, "southwest": { "lat": -33.86009812989271, "lng": 151.2085439701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png", "icon_background_color": "#FF9E67", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet", "name": "Cruise Bar", "opening_hours": { "open_now": false }, "photos": [ { "height": 608, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG", "width": 1080, }, ], "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI", "plus_code": { "compound_code": "46R6+G2 The Rocks, New South Wales", "global_code": "4RRH46R6+G2", }, "price_level": 2, "rating": 4, "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI", "scope": "GOOGLE", "types": ["bar", "restaurant", "food", "point_of_interest", "establishment"], "user_ratings_total": 1269, "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8675219, "lng": 151.2016502 }, "viewport": { "northeast": { "lat": -33.86614532010728, "lng": 151.2031259298927 }, "southwest": { "lat": -33.86884497989272, "lng": 151.2004262701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Sydney Harbour Dinner Cruises", "opening_hours": { "open_now": true }, "photos": [ { "height": 835, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7", "width": 1200, }, ], "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids", "plus_code": { "compound_code": "46J2+XM Sydney, New South Wales", "global_code": "4RRH46J2+XM", }, "rating": 4.8, "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids", "scope": "GOOGLE", "types": [ "tourist_attraction", "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 9, "vicinity": "32 The Promenade, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8676569, "lng": 151.2017213 }, "viewport": { "northeast": { "lat": -33.86629922010728, "lng": 151.2031712798927 }, "southwest": { "lat": -33.86899887989272, "lng": 151.2004716201073 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Clearview Sydney Harbour Cruises", "opening_hours": { "open_now": false }, "photos": [ { "height": 685, "html_attributions": [ 'Clearview Glass Boat Cruises', ], "photo_reference": "Aap_uEAlExjnXA0VWyb_oYwCJ8utWG_Ennhwmn_xadpgenMNUgTuxrvgf1Xdw4bsbL6kFSWH7bhbpVHK1esdNY37ancJvbL_Gnsc7EZ5KEBNPvYZ_ZEyLco4a5v34LFkodxfFZbJ-ejO3zN4W_0C37P5jAmTnLWMNFYUPvoU3UMi70qHRNF5", "width": 1024, }, ], "place_id": "ChIJNQfwZTiuEmsR1m1x9w0E2V0", "plus_code": { "compound_code": "46J2+WM Sydney, New South Wales", "global_code": "4RRH46J2+WM", }, "rating": 3.8, "reference": "ChIJNQfwZTiuEmsR1m1x9w0E2V0", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 49, "vicinity": "32 The Promenade King Street Wharf 5, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8677035, "lng": 151.2017297 }, "viewport": { "northeast": { "lat": -33.86634597010728, "lng": 151.2031781298927 }, "southwest": { "lat": -33.86904562989272, "lng": 151.2004784701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Sydney Harbour Lunch Cruise", "opening_hours": { "open_now": false }, "photos": [ { "height": 545, "html_attributions": [ 'Sydney Harbour Lunch Cruise', ], "photo_reference": "Aap_uEBFyQ2xDzHk7dGF_FTvNeJ01NQD6GROq89rufdGQl5Gi0zVfpnETBjPK2v7UEDl_6F-m8aR5FcEWJMqPaH4Oh_CQh2jaUAUAesUInucpCe7OFdleSYJ_8kgunhsIvGf1D1s_pes6Rk2JMVEs8rEs6ZHSTmUQXX2Yh-Gt9MuPQdYNuNv", "width": 969, }, ], "place_id": "ChIJUbf3iDiuEmsROJxXbhYO7cM", "plus_code": { "compound_code": "46J2+WM Sydney, New South Wales", "global_code": "4RRH46J2+WM", }, "rating": 3.9, "reference": "ChIJUbf3iDiuEmsROJxXbhYO7cM", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 23, "vicinity": "5/32 The Promenade, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8675883, "lng": 151.2016452 }, "viewport": { "northeast": { "lat": -33.86623847010728, "lng": 151.2029950298927 }, "southwest": { "lat": -33.86893812989273, "lng": 151.2002953701073 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Sydney Showboats - Dinner Cruise With Show", "opening_hours": { "open_now": false }, "photos": [ { "height": 4912, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uED1aGaMs8xYfiuzeBqVcFsk3yguUujdE4S3rNThMpLtoU0RukF40KCt0CAxgHP1HoY8Z7NYcWvax6qmMMVPBbmzGhoaiwiAAyv2GGA9vhcgsJ5w0LweT0y1lgRGZxU3nZIdNLiYAp9JHM171UkN04H6UqYSxKVZ8N_f2aslkqOaBF_e", "width": 7360, }, ], "place_id": "ChIJjRuIiTiuEmsRCHhYnrWiSok", "plus_code": { "compound_code": "46J2+XM Sydney, New South Wales", "global_code": "4RRH46J2+XM", }, "rating": 4.1, "reference": "ChIJjRuIiTiuEmsRCHhYnrWiSok", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 119, "vicinity": "32 The Promenade, King Street Wharf, 5, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8677035, "lng": 151.2017297 }, "viewport": { "northeast": { "lat": -33.86634597010728, "lng": 151.2031781298927 }, "southwest": { "lat": -33.86904562989272, "lng": 151.2004784701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Magistic Cruises", "opening_hours": { "open_now": true }, "photos": [ { "height": 1536, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEC8bq-YphfIDcdxANBfgGMBIX2B0ggNep9ddVoePj6sfdcdusIn07x8biaxevZ_6BpzDDRsUL8No5P3ftI4on_pqbAbIEUL5gFGgezpVZ3M9GWvKdJm3njO_aJaghWl4_aQb75c0WGYDRFPhn6fWsLkD7KxodviJeCX4OCGt1eRJnlK", "width": 2048, }, ], "place_id": "ChIJxRjqYTiuEmsRGebAA_chDLE", "plus_code": { "compound_code": "46J2+WM Sydney, New South Wales", "global_code": "4RRH46J2+WM", }, "rating": 3.9, "reference": "ChIJxRjqYTiuEmsRGebAA_chDLE", "scope": "GOOGLE", "types": [ "tourist_attraction", "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 99, "vicinity": "King Street Wharf, 32 The Promenade, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8609391, "lng": 151.2098735 }, "viewport": { "northeast": { "lat": -33.85958927010727, "lng": 151.2112233298927 }, "southwest": { "lat": -33.86228892989272, "lng": 151.2085236701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Australian Cruise Group", "opening_hours": { "open_now": false }, "photos": [ { "height": 1536, "html_attributions": [ 'Keith Bauman', ], "photo_reference": "Aap_uED7aBwIbN6iuoZi8e9xCrt6F_EhppGCBfzYCgypetw8cGn4Ui0Y3JZe3QJ0buf0zc54BtPz-SWXxecPd6kDvNNZD5Eu_ZzTP13rXMzSDJa6UcwFiXU4y3qYrWAyJ6mtYrd2PJgw0KzvYaZoPze7Ka6zG6k3IOjeSICDYH6YOzkXhelj", "width": 2048, }, ], "place_id": "ChIJpU8KgUKuEmsRKErVGEaa11w", "plus_code": { "compound_code": "46Q5+JW Sydney, New South Wales", "global_code": "4RRH46Q5+JW", }, "rating": 4.4, "reference": "ChIJpU8KgUKuEmsRKErVGEaa11w", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 5, "vicinity": "6 Cirular Quay, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8686058, "lng": 151.2018206 }, "viewport": { "northeast": { "lat": -33.86730002010728, "lng": 151.2032717798927 }, "southwest": { "lat": -33.86999967989272, "lng": 151.2005721201073 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Rhythmboat Cruises", "opening_hours": { "open_now": false }, "photos": [ { "height": 2269, "html_attributions": [ 'Rhythmboat Sydney Harbour Cruises', ], "photo_reference": "Aap_uEAT8eop-IsfSAQ3KP6YXRNRsFkESXDecsaPnaVhq5bZzny5guvhS4smciianRGbZgDtFtAcU-ZXTaBfuh80CFw8vpJyKaB4grgW_CW64rU1JF9FDy_M8HtEk3rOrMhPDiF8ns-mc16E4rWSuAQIc76Du_eCd63ofoErESOtSWAQVcew", "width": 4032, }, ], "place_id": "ChIJyWEHuEmuEmsRm9hTkapTCrk", "plus_code": { "compound_code": "46J2+HP Sydney, New South Wales", "global_code": "4RRH46J2+HP", }, "rating": 3.9, "reference": "ChIJyWEHuEmuEmsRm9hTkapTCrk", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 30, "vicinity": "King Street Wharf, King St, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8712692, "lng": 151.1898651 }, "viewport": { "northeast": { "lat": -33.86952792010727, "lng": 151.1914560298927 }, "southwest": { "lat": -33.87222757989272, "lng": 151.1887563701073 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Glass Island", "opening_hours": { "open_now": false }, "photos": [ { "height": 4480, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEAaToCBaHP7Gfdjc740gwIkQcjeUD97NO0TKXJ5IXB0CLGQA6slEpHn4k9LwyhoAzzbSTXJduYyFIkHVmQWGp34NggRxrtOWp7sJf5N6j0ASYlJPmAtWUaaCWnbx_pxdndsopeJ7PYn9kTiMgFcSs-GeipI8hDZgAJswMBnfsO0xWQ-", "width": 6720, }, ], "place_id": "ChIJnScuboavEmsRyh-FGxhc3pw", "plus_code": { "compound_code": "45HQ+FW Pyrmont, New South Wales", "global_code": "4RRH45HQ+FW", }, "rating": 4.1, "reference": "ChIJnScuboavEmsRyh-FGxhc3pw", "scope": "GOOGLE", "types": ["bar", "restaurant", "food", "point_of_interest", "establishment"], "user_ratings_total": 90, "vicinity": "37 Bank St, Pyrmont", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.85876140000001, "lng": 151.2100004 }, "viewport": { "northeast": { "lat": -33.85737742010728, "lng": 151.2111319298927 }, "southwest": { "lat": -33.86007707989272, "lng": 151.2084322701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png", "icon_background_color": "#FF9E67", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet", "name": "Junk Lounge", "opening_hours": { "open_now": false }, "photos": [ { "height": 608, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEDaHF9VZFV88tQqFyIgmPlcbCsK-ScCGuUVGh0mTAP4OzWh_0q0T5rPbeC7bas7vD5vC9oS95jtdr4oOnQmhGDAIbHkv4E6UHrQIl0f3XZ-3-RRDjn293w4qQb_BfhbPPO3nokU7npfMfVvCcelWf9WHiWNHT4EEHrFtvuhAWKobTnC", "width": 1080, }, ], "place_id": "ChIJq9W3HZOvEmsRYtKNTRmq34M", "plus_code": { "compound_code": "46R6+F2 The Rocks, New South Wales", "global_code": "4RRH46R6+F2", }, "price_level": 2, "rating": 4.1, "reference": "ChIJq9W3HZOvEmsRYtKNTRmq34M", "scope": "GOOGLE", "types": ["restaurant", "food", "point_of_interest", "establishment"], "user_ratings_total": 63, "vicinity": "Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8677035, "lng": 151.2017297 }, "viewport": { "northeast": { "lat": -33.86634597010728, "lng": 151.2031781298927 }, "southwest": { "lat": -33.86904562989272, "lng": 151.2004784701072 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Sydney New Year's Eve Cruises", "opening_hours": { "open_now": true }, "photos": [ { "height": 1600, "html_attributions": [ 'A Google User', ], "photo_reference": "Aap_uEDceKHtQ9Hf2eHwnQYXLqrwZ1X2LYVhsfXbqrpIm3_lXZ9apURjAXtVgRVTGxJPD7BtaqR8C7bwaSTakmi0Pazn7g3suj8ZaQRBqheT3KVJDhZ9_GwVInLkWbxqnhivEXs1a-MC_J8XF1SL_5AQ3mAETgiLRQ04116IAEV5vHyIGRsa", "width": 2400, }, ], "place_id": "ChIJ__8_hziuEmsR27ucFXECfOg", "plus_code": { "compound_code": "46J2+WM Sydney, New South Wales", "global_code": "4RRH46J2+WM", }, "rating": 5, "reference": "ChIJ__8_hziuEmsR27ucFXECfOg", "scope": "GOOGLE", "types": [ "travel_agency", "restaurant", "food", "point_of_interest", "establishment", ], "user_ratings_total": 5, "vicinity": "King Street Wharf 5, 32 The Promenade, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.8669866, "lng": 151.2017231 }, "viewport": { "northeast": { "lat": -33.86563197010727, "lng": 151.2031347298927 }, "southwest": { "lat": -33.86833162989272, "lng": 151.2004350701073 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#13B5C7", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "King Street Wharf Darling Harbour", "opening_hours": { "open_now": true }, "photos": [ { "height": 3024, "html_attributions": [ '朱品貞', ], "photo_reference": "Aap_uEDwKXVOjIaCj3LptOdd86B5umsdG7Z3jcvqcpUVLwHS6w8VGEkphgC8-shAx95CrsuXpnKz-XVIixVmgagQHKPH3vSLLqJ6LOAR7Q-_jiyx3ELXD0pm7AARiAtQAMBN9A-oqbtvGbE27yDpvBS1lKe9PCm-dMfrHIIcsS91Qeq2E4b6", "width": 4032, }, ], "place_id": "ChIJkfDzJ72vEmsR8xtYbk5f0p0", "plus_code": { "compound_code": "46M2+6M Sydney, New South Wales", "global_code": "4RRH46M2+6M", }, "rating": 4.4, "reference": "ChIJkfDzJ72vEmsR8xtYbk5f0p0", "scope": "GOOGLE", "types": [ "tourist_attraction", "convenience_store", "bowling_alley", "travel_agency", "bar", "restaurant", "food", "point_of_interest", "store", "establishment", ], "user_ratings_total": 3213, "vicinity": "The Promenade, Lime St, Sydney", }, { "business_status": "OPERATIONAL", "geometry": { "location": { "lat": -33.870383, "lng": 151.1979245 }, "viewport": { "northeast": { "lat": -33.86901092010727, "lng": 151.1991702798927 }, "southwest": { "lat": -33.87171057989271, "lng": 151.1964706201073 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png", "icon_background_color": "#FF9E67", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet", "name": "The Little Snail Restaurant", "opening_hours": { "open_now": false }, "photos": [ { "height": 900, "html_attributions": [ 'The Little Snail', ], "photo_reference": "Aap_uEA9aHKkB_6VoFx4VHRSp19PCwnTOuGfpmDYw1NdYNbzncfdjjfEmiiFz-E4tIJ6iGVZjR_bejX6wNr5thJjqlcdQ2PvPyTTo1jGtxk31JG9b6Vd0vu_v4Ep7yutzf3KTzBjYFBIGsYPf3Pj0DptMWPLP7fn33SBT7YmRqDEoGcUsBzw", "width": 1350, }, ], "place_id": "ChIJtwapWjeuEmsRcxV5JARHpSk", "plus_code": { "compound_code": "45HX+R5 Pyrmont, New South Wales", "global_code": "4RRH45HX+R5", }, "price_level": 2, "rating": 4.5, "reference": "ChIJtwapWjeuEmsRcxV5JARHpSk", "scope": "GOOGLE", "types": ["restaurant", "food", "point_of_interest", "establishment"], "user_ratings_total": 1916, "vicinity": "3/50 Murray St, Pyrmont", }, ], "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceSearchResponse> <status>OK</status> <result> <name>Cruise Bar</name> <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity> <type>bar</type> <type>restaurant</type> <type>food</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8587323</lat> <lng>151.2100055</lng> </location> <viewport> <southwest> <lat>-33.8600981</lat> <lng>151.2085440</lng> </southwest> <northeast> <lat>-33.8573985</lat> <lng>151.2112436</lng> </northeast> </viewport> </geometry> <rating>4.0</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon> <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference> <width>1080</width> <height>608</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112582655193348962755">A Google User</a></html_attribution> </photo> <price_level>2</price_level> <user_ratings_total>1269</user_ratings_total> <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46R6+G2</global_code> <compound_code>46R6+G2 The Rocks, New South Wales</compound_code> </plus_code> <icon_background_color>#FF9E67</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet</icon_mask_base_uri> </result> <result> <name>Sydney Harbour Dinner Cruises</name> <vicinity>32 The Promenade, Sydney</vicinity> <type>tourist_attraction</type> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8675219</lat> <lng>151.2016502</lng> </location> <viewport> <southwest> <lat>-33.8688450</lat> <lng>151.2004263</lng> </southwest> <northeast> <lat>-33.8661453</lat> <lng>151.2031259</lng> </northeast> </viewport> </geometry> <rating>4.8</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference> <opening_hours> <open_now>true</open_now> </opening_hours> <photo> <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference> <width>1200</width> <height>835</height> <html_attribution><a href="https://maps.google.com/maps/contrib/109764923610545394994">A Google User</a></html_attribution> </photo> <user_ratings_total>9</user_ratings_total> <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+XM</global_code> <compound_code>46J2+XM Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>Clearview Sydney Harbour Cruises</name> <vicinity>32 The Promenade King Street Wharf 5, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8676569</lat> <lng>151.2017213</lng> </location> <viewport> <southwest> <lat>-33.8689989</lat> <lng>151.2004716</lng> </southwest> <northeast> <lat>-33.8662992</lat> <lng>151.2031713</lng> </northeast> </viewport> </geometry> <rating>3.8</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJNQfwZTiuEmsR1m1x9w0E2V0</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uED7hBZqIUaBgFu5q8_xoLMrkWIXUau5D7J2T2fS3HAk4j3aoOp5MQKiujaS8ByzfU9zshp37EMMW6tZe67qLYku2AW-QOVeTbJlyxQ7bqgtSZ_YTo_ES1Xw1bBx8wv8BJYTJZFRzh8enBdH0kLy-oICBpm2fDexARp4CG8Dsxz5bqGA</photo_reference> <width>1024</width> <height>685</height> <html_attribution><a href="https://maps.google.com/maps/contrib/114394575270272775071">Clearview Glass Boat Cruises</a></html_attribution> </photo> <user_ratings_total>49</user_ratings_total> <place_id>ChIJNQfwZTiuEmsR1m1x9w0E2V0</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+WM</global_code> <compound_code>46J2+WM Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>Sydney Harbour Lunch Cruise</name> <vicinity>5/32 The Promenade, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8677035</lat> <lng>151.2017297</lng> </location> <viewport> <southwest> <lat>-33.8690456</lat> <lng>151.2004785</lng> </southwest> <northeast> <lat>-33.8663460</lat> <lng>151.2031781</lng> </northeast> </viewport> </geometry> <rating>3.9</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJUbf3iDiuEmsROJxXbhYO7cM</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uED1kwFA2W4XWHpSNZBxiE10JfyZEJrOz8aAPXpR2GbOg0Pc-yPHJYjt6m007fRdSG2PzvsWdZIFE-lny_NRBGUrSzpk9eNVzDp3GLUeV9G0HXcQv7IhEK6vtm_Updlv66bi8S07h3e_lFiHIzFw0TLVfWXjc63Pm94NN1kug7RPJa-6</photo_reference> <width>969</width> <height>545</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102428257696490257922">Sydney Harbour Lunch Cruise</a></html_attribution> </photo> <user_ratings_total>23</user_ratings_total> <place_id>ChIJUbf3iDiuEmsROJxXbhYO7cM</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+WM</global_code> <compound_code>46J2+WM Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>Sydney Showboats - Dinner Cruise With Show</name> <vicinity>32 The Promenade, King Street Wharf, 5, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8675883</lat> <lng>151.2016452</lng> </location> <viewport> <southwest> <lat>-33.8689381</lat> <lng>151.2002954</lng> </southwest> <northeast> <lat>-33.8662385</lat> <lng>151.2029950</lng> </northeast> </viewport> </geometry> <rating>4.1</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJjRuIiTiuEmsRCHhYnrWiSok</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEAGYIvNdkpJvsbVLPNaMlKukR9jvX48rKMo_TPqbSBRYqvYGExwQM8YvHrz83U7UOJosNI0kay5wV9vZdr9fR12ElFlK5fY3xdoS9N9T08ejq2gLABJJK-Bwl4W2IPw9imoWef1BYMVP07WhXhVOs05a-2A3Qm5fKCRILgUis5pMeCg</photo_reference> <width>7360</width> <height>4912</height> <html_attribution><a href="https://maps.google.com/maps/contrib/105311284660389698992">A Google User</a></html_attribution> </photo> <user_ratings_total>119</user_ratings_total> <place_id>ChIJjRuIiTiuEmsRCHhYnrWiSok</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+XM</global_code> <compound_code>46J2+XM Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>Magistic Cruises</name> <vicinity>King Street Wharf, 32 The Promenade, Sydney</vicinity> <type>tourist_attraction</type> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8677035</lat> <lng>151.2017297</lng> </location> <viewport> <southwest> <lat>-33.8690456</lat> <lng>151.2004785</lng> </southwest> <northeast> <lat>-33.8663460</lat> <lng>151.2031781</lng> </northeast> </viewport> </geometry> <rating>3.9</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJxRjqYTiuEmsRGebAA_chDLE</reference> <opening_hours> <open_now>true</open_now> </opening_hours> <photo> <photo_reference>Aap_uEDbALKhgsD-bIG6fWxrermkmKtpIKDHthAySc9EjPEpWDQQtYsSgB4AqLVMArTFCWd04Vb9U51st96ONjtDmWf8KsjKwYtkWxYDFzaY9ZmO2UQpV3rnqjmNHXtIsCdjjwADQbumAkjn5WzBJ-DqlVZs9NmlpLvAY6Jg4DGhduWdewv4</photo_reference> <width>2048</width> <height>1536</height> <html_attribution><a href="https://maps.google.com/maps/contrib/103073818292552522030">A Google User</a></html_attribution> </photo> <user_ratings_total>99</user_ratings_total> <place_id>ChIJxRjqYTiuEmsRGebAA_chDLE</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+WM</global_code> <compound_code>46J2+WM Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>Australian Cruise Group</name> <vicinity>6 Cirular Quay, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8609391</lat> <lng>151.2098735</lng> </location> <viewport> <southwest> <lat>-33.8622889</lat> <lng>151.2085237</lng> </southwest> <northeast> <lat>-33.8595893</lat> <lng>151.2112233</lng> </northeast> </viewport> </geometry> <rating>4.4</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJpU8KgUKuEmsRKErVGEaa11w</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uECGcpPB2lEO6gIB3QzHeviDhXcG-RV3TXuJPiBHGWbDxnflOhymebF45afUMBIW9r3xC2_gHfiqicV4VnooMJ2-Kwy0YocFXk1_0kkmR1HPV2D9kN9h-yPVK5d6oSPMdmY4MjCut3n8Tv9vt6iu44DDnafb2j78R34EcLQ4iFl0sots</photo_reference> <width>2048</width> <height>1536</height> <html_attribution><a href="https://maps.google.com/maps/contrib/113088009011192061895">Keith Bauman</a></html_attribution> </photo> <user_ratings_total>5</user_ratings_total> <place_id>ChIJpU8KgUKuEmsRKErVGEaa11w</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46Q5+JW</global_code> <compound_code>46Q5+JW Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>Rhythmboat Cruises</name> <vicinity>King Street Wharf, King St, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8686058</lat> <lng>151.2018206</lng> </location> <viewport> <southwest> <lat>-33.8699997</lat> <lng>151.2005721</lng> </southwest> <northeast> <lat>-33.8673000</lat> <lng>151.2032718</lng> </northeast> </viewport> </geometry> <rating>3.9</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJyWEHuEmuEmsRm9hTkapTCrk</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEAP5i23uwF3dotBD71Tr0YcEXCHnPOem0CKzKev5YX5dvp63wX7rbLZ3bHNNshIf9P0v3z6GKdF8yJkX3wxXWvzv7EfLwWbwGXYkA-vrXm72ek66P1FlNtNHcbIIyF9HQ1MDXZAhwLcnNJObbk8z9lKmCkBQJCQnkLsGHshZ_ZZCM6L</photo_reference> <width>4032</width> <height>2269</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104066891898402903288">Rhythmboat Sydney Harbour Cruises</a></html_attribution> </photo> <user_ratings_total>30</user_ratings_total> <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+HP</global_code> <compound_code>46J2+HP Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>Glass Island</name> <vicinity>37 Bank St, Pyrmont</vicinity> <type>bar</type> <type>restaurant</type> <type>food</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8712692</lat> <lng>151.1898651</lng> </location> <viewport> <southwest> <lat>-33.8722276</lat> <lng>151.1887564</lng> </southwest> <northeast> <lat>-33.8695279</lat> <lng>151.1914560</lng> </northeast> </viewport> </geometry> <rating>4.1</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJnScuboavEmsRyh-FGxhc3pw</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uECzZC-aNaQunm_EMgTFeFyR5-u7E19MSZNuRbK14Tq-GxK-glsLoeqtmdOkA307MesbO6Xqau_7bGM4w5vwxMnPPkc8tEQniNQjgC1M1g9OpMwdd4_8nhmBwOMkzUZk1KU0R9CFYxx7YY5a-HywQSK8kTr1FLXX3y23bSkaDvsgenBr</photo_reference> <width>6720</width> <height>4480</height> <html_attribution><a href="https://maps.google.com/maps/contrib/117745044320706972021">A Google User</a></html_attribution> </photo> <user_ratings_total>90</user_ratings_total> <place_id>ChIJnScuboavEmsRyh-FGxhc3pw</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH45HQ+FW</global_code> <compound_code>45HQ+FW Pyrmont, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>Junk Lounge</name> <vicinity>Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity> <type>restaurant</type> <type>food</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8587614</lat> <lng>151.2100004</lng> </location> <viewport> <southwest> <lat>-33.8600771</lat> <lng>151.2084323</lng> </southwest> <northeast> <lat>-33.8573774</lat> <lng>151.2111319</lng> </northeast> </viewport> </geometry> <rating>4.1</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon> <reference>ChIJq9W3HZOvEmsRYtKNTRmq34M</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEBNQHy0vHfeUWJid28kkZIf4EcgMp50UmkpvhoYPwZJBYImlASnKV4fHlaXTlNQI8H_jUqDpToiMwFOE2XsDpHBdLeZGxpoMq5ThL1gSEMo1zp9U_Pd5jhamilQbpkEeZN_CVeHLAnOX5CG21IF8pda1Zj8IuuENzaKi2BLNQ5TCyYq</photo_reference> <width>1080</width> <height>608</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104473997089847488714">A Google User</a></html_attribution> </photo> <price_level>2</price_level> <user_ratings_total>63</user_ratings_total> <place_id>ChIJq9W3HZOvEmsRYtKNTRmq34M</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46R6+F2</global_code> <compound_code>46R6+F2 The Rocks, New South Wales</compound_code> </plus_code> <icon_background_color>#FF9E67</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri> </result> <result> <name>Sydney New Year's Eve Cruises</name> <vicinity>King Street Wharf 5, 32 The Promenade, Sydney</vicinity> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8677035</lat> <lng>151.2017297</lng> </location> <viewport> <southwest> <lat>-33.8690456</lat> <lng>151.2004785</lng> </southwest> <northeast> <lat>-33.8663460</lat> <lng>151.2031781</lng> </northeast> </viewport> </geometry> <rating>5.0</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJ__8_hziuEmsR27ucFXECfOg</reference> <opening_hours> <open_now>true</open_now> </opening_hours> <photo> <photo_reference>Aap_uEB3hrLc-p5rV8oczY8fo4vdDdw1c0ZXLzbcgek15WzOon1Qd3WbMfmx994E05fFb5Tt1E60Iux0jaEwGkoy477ru-ZYRD1KUZrfMNw46ciZhnHRD2ZX_nWVYkw2VG_AdEDw1DJ3YQEuDP4EJ5IpsoKianbWyIlmaeuy63TfjdvuFs18</photo_reference> <width>2400</width> <height>1600</height> <html_attribution><a href="https://maps.google.com/maps/contrib/115281801304517408477">A Google User</a></html_attribution> </photo> <user_ratings_total>5</user_ratings_total> <place_id>ChIJ__8_hziuEmsR27ucFXECfOg</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46J2+WM</global_code> <compound_code>46J2+WM Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>King Street Wharf Darling Harbour</name> <vicinity>The Promenade, Lime St, Sydney</vicinity> <type>tourist_attraction</type> <type>bowling_alley</type> <type>convenience_store</type> <type>bar</type> <type>restaurant</type> <type>food</type> <type>travel_agency</type> <type>point_of_interest</type> <type>store</type> <type>establishment</type> <geometry> <location> <lat>-33.8669866</lat> <lng>151.2017231</lng> </location> <viewport> <southwest> <lat>-33.8683316</lat> <lng>151.2004351</lng> </southwest> <northeast> <lat>-33.8656320</lat> <lng>151.2031347</lng> </northeast> </viewport> </geometry> <rating>4.4</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJkfDzJ72vEmsR8xtYbk5f0p0</reference> <opening_hours> <open_now>true</open_now> </opening_hours> <photo> <photo_reference>Aap_uEACFUVsoIAR-DdQfFF-95EUG-vLZ4rE0twMHUMam4JM7qPjrfmrVpC80g8CHtMEcimKBxtiGYaEVp7dw12FhfkJw8hZI-bK4Ls9BY3AnvdoUbfVkBvLC7yqT5ly-gMW2ZT8rLc5-mKaZHbWZyZEPgWs84Qd6KPnEKRx6dGNEevYaUlL</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/101920674986627213698">朱品貞</a></html_attribution> </photo> <user_ratings_total>3213</user_ratings_total> <place_id>ChIJkfDzJ72vEmsR8xtYbk5f0p0</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH46M2+6M</global_code> <compound_code>46M2+6M Sydney, New South Wales</compound_code> </plus_code> <icon_background_color>#13B5C7</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> <result> <name>The Little Snail Restaurant</name> <vicinity>3/50 Murray St, Pyrmont</vicinity> <type>restaurant</type> <type>food</type> <type>point_of_interest</type> <type>establishment</type> <geometry> <location> <lat>-33.8703830</lat> <lng>151.1979245</lng> </location> <viewport> <southwest> <lat>-33.8717106</lat> <lng>151.1964706</lng> </southwest> <northeast> <lat>-33.8690109</lat> <lng>151.1991703</lng> </northeast> </viewport> </geometry> <rating>4.5</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon> <reference>ChIJtwapWjeuEmsRcxV5JARHpSk</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEB9EuRqd4be_9HrlUI7lbC5aDokS8UASO_ogA9OFQwEZsFD_jXDwK2Xc2kQm_wDE9TBI_20Na4TcRkgZoers93pw9cJ5RAbedKbUYAvAJz9c-zWKdqRd7pWaOlInQmbJVohI4ZsqbtlhynDqmfgX1SIccGuh066nlxyX7oFvYoLSbNb</photo_reference> <width>1350</width> <height>900</height> <html_attribution><a href="https://maps.google.com/maps/contrib/114727320476039103791">The Little Snail</a></html_attribution> </photo> <price_level>2</price_level> <user_ratings_total>1916</user_ratings_total> <place_id>ChIJtwapWjeuEmsRcxV5JARHpSk</place_id> <scope>GOOGLE</scope> <plus_code> <global_code>4RRH45HX+R5</global_code> <compound_code>45HX+R5 Pyrmont, New South Wales</compound_code> </plus_code> <icon_background_color>#FF9E67</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri> </result> </PlaceSearchResponse>
PlacesNearbySearchResponse
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | Array<string> |
قد يحتوي على مجموعة من بيانات المصدر حول هذا الإدخال يجب عرضها للمستخدم (قد لا تتضمّن بعض الإدخالات بيانات المصدر). |
|
مطلوب | Array<Place> |
تحتوي على مصفوفة من الأماكن.
تعرض طلبات البحث عن الأماكن مجموعة فرعية من الحقول التي تعرضها طلبات تفاصيل المكان. إذا لم يعرض طلب البحث عن الأماكن الحقل الذي تريده، يمكنك استخدام طلب البحث عن الأماكن للحصول على
place_id، ثم استخدام رقم تعريف المكان هذا لتقديم طلب تفاصيل المكان.
اطّلِع على مكان لمزيد من المعلومات. |
|
مطلوب | PlacesSearchStatus |
يحتوي على حالة الطلب، وقد يتضمّن معلومات تصحيح الأخطاء لمساعدتك في معرفة سبب تعذُّر تلبية الطلب. يُرجى الاطّلاع على PlacesSearchStatus لمزيد من المعلومات. |
|
اختياري | سلسلة |
عندما تعرض الخدمة رمز حالة غير |
|
اختياري | Array<string> |
عندما تعرض الخدمة معلومات إضافية حول مواصفات الطلب، قد يكون هناك حقل |
|
اختياري | سلسلة |
يحتوي على رمز مميّز يمكن استخدامه لعرض ما يصل إلى 20 نتيجة إضافية. لن يتم عرض next_page_token إذا لم تكن هناك نتائج إضافية لعرضها. الحد الأقصى لعدد النتائج التي يمكن عرضها هو 60. يحدث تأخير قصير بين وقت إصدار الرمز المميّز next_page_token ووقت أن يصبح صالحًا. |
PlacesSearchStatus
رموز الحالة التي تعرضها الخدمة
OKيشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تمّ بنجاح.-
ZERO_RESULTS، ما يشير إلى أنّ البحث تم بنجاح ولكن لم يتم عرض أي نتائج. قد يحدث ذلك إذا تم تمريرlatlngإلى البحث في موقع جغرافي بعيد. -
INVALID_REQUESTيشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات مكتوب بشكلٍ غير صحيح، ويحدث ذلك عادةً بسبب عدم توفّر معلَمة طلب البحث المطلوبة (locationأوradius). -
OVER_QUERY_LIMITالتي تشير إلى أي مما يلي:- لقد تجاوزت الحدّ الأقصى لعدد الطلبات في الثانية.
- لم يتم تفعيل الفوترة في حسابك.
- تم تجاوز رصيد بقيمة 200 دولار أمريكي شهريًا أو الحد الأقصى للاستخدام الذي فرضته على نفسك.
- لم تعُد طريقة الدفع المقدَّمة صالحة (على سبيل المثال، انتهت صلاحية بطاقة ائتمان).
-
REQUEST_DENIEDيشير إلى أنّه تم رفض طلبك، ويكون السبب عادةً أحد ما يلي:- لا يتضمّن الطلب مفتاح واجهة برمجة التطبيقات.
- المَعلمة
keyغير صالحة.
-
UNKNOWN_ERRORللإشارة إلى حدوث خطأ غير معروف.
مكان العمل
تمثّل هذه السمة سمات تصف مكانًا. لن تتوفّر بعض السمات لبعض أنواع الأماكن.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري | Array<AddressComponent> |
تمثّل هذه السمة مصفوفة تحتوي على المكوّنات المنفصلة التي تنطبق على هذا العنوان. يمكنك الاطّلاع على AddressComponent للحصول على مزيد من المعلومات. |
|
اختياري | سلسلة |
تمثّل هذه السمة عنوان المكان بتنسيق adr microformat. |
|
اختياري | سلسلة |
تشير هذه السمة إلى حالة التشغيل الخاصة بالمكان، إذا كان نشاطًا تجاريًا.
في حال عدم توفّر بيانات، لن يتم عرض
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
اختياري | قيمة منطقية |
تحدِّد ما إذا كان النشاط التجاري يتيح خدمة استلام الطلبات من السيارة. |
|
اختياري | PlaceOpeningHours |
يحتوي هذا الحقل على ساعات العمل للأيام السبعة المقبلة (بما في ذلك اليوم). تبدأ الفترة الزمنية في منتصف الليل من تاريخ الطلب وتنتهي في الساعة 11:59 مساءً بعد ستة أيام. يتضمّن هذا الحقل الحقل الفرعي يمكنك الاطّلاع على PlaceOpeningHours للحصول على مزيد من المعلومات. |
|
اختياري | قيمة منطقية |
تحدِّد ما إذا كان النشاط التجاري يقدّم خدمة توصيل. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان النشاط التجاري يوفّر أماكن للجلوس في الداخل أو في الهواء الطلق. |
|
اختياري | PlaceEditorialSummary |
يحتوي على ملخّص عن المكان. يتألف الملخّص من نظرة عامة نصية، ويتضمّن أيضًا رمز اللغة إذا كان ذلك منطبقًا. يجب عرض نص الملخّص كما هو، ولا يمكن تعديله أو تغييره. يمكنك الاطّلاع على PlaceEditorialSummary للحصول على مزيد من المعلومات. |
|
اختياري | سلسلة |
سلسلة تحتوي على العنوان الذي يمكن لشخص عادي قراءته لهذا المكان وغالبًا ما يكون هذا العنوان مطابقًا للعنوان البريدي. يُرجى العِلم أنّ بعض البلدان، مثل المملكة المتحدة، لا تسمح بتوزيع العناوين البريدية الحقيقية بسبب القيود المفروضة على الترخيص. يتألف العنوان المنسّق منطقيًا من مكوّن واحد أو أكثر من مكوّنات العنوان. على سبيل المثال، يتألف العنوان "111 شارع 8، نيويورك، نيويورك" من المكوّنات التالية: "111" (رقم الشارع) و"شارع 8" (الطريق) و"نيويورك" (المدينة) و "نيويورك" (ولاية الولايات المتحدة). لا تحلّل العنوان المنسَّق آليًا. بدلاً من ذلك، عليك استخدام مكوّنات العنوان الفردية التي يتضمّنها ردّ من واجهة برمجة التطبيقات بالإضافة إلى حقل العنوان المنسّق. |
|
اختياري | سلسلة |
يحتوي على رقم الهاتف الخاص بالمكان بالتنسيق المحلي. |
|
اختياري | الأشكال الهندسية |
يحتوي على الموقع الجغرافي ونافذة العرض الخاصة به. راجِع الشكل الهندسي لمزيد من المعلومات. |
|
اختياري | سلسلة |
يحتوي على عنوان URL لرمز مقترَح يمكن عرضه للمستخدم عند الإشارة إلى هذه النتيجة على خريطة. |
|
اختياري | سلسلة |
تحتوي هذه السمة على رمز اللون السداسي العشري التلقائي لفئة المكان. |
|
اختياري | سلسلة |
يحتوي على عنوان URL لرمز مقترَح، باستثناء امتداد نوع الملف |
|
اختياري | سلسلة |
يحتوي على رقم الهاتف الخاص بالمكان بالتنسيق الدولي.
يتضمّن التنسيق الدولي رمز البلد، ويسبقه علامة الجمع (+). على سبيل المثال، رقم الهاتف الدولي لمكتب Google في سيدني، أستراليا هو |
|
اختياري | سلسلة |
تحتوي على الاسم الذي يمكن للمستخدم قراءته للنتيجة التي تم إرجاعها. بالنسبة إلى نتائج |
|
اختياري | PlaceOpeningHours |
يحتوي على ساعات العمل العادية. يمكنك الاطّلاع على PlaceOpeningHours للحصول على مزيد من المعلومات. |
|
اختياري | قيمة منطقية |
استخدِم |
|
اختياري | Array<PlacePhoto> |
مصفوفة من عناصر الصور، يحتوي كل منها على مرجع إلى صورة قد يعرض الطلب ما يصل إلى عشر صور. يمكنك الاطّلاع على مزيد من المعلومات حول صور الأماكن وكيفية استخدام الصور في تطبيقك في مستندات صور الأماكن. يُرجى الاطّلاع على PlacePhoto للحصول على مزيد من المعلومات. |
|
اختياري | سلسلة |
معرّف نصي يحدّد مكانًا بشكل فريد. لاسترداد معلومات حول المكان، مرِّر هذا المعرّف في الحقل |
|
اختياري | PlusCode |
مرجع موقع جغرافي مشفّر، مشتق من إحداثيات خطوط الطول والعرض، ويمثّل منطقة: 1/8000 من الدرجة في 1/8000 من الدرجة (حوالي 14 مترًا × 14 مترًا عند خط الاستواء) أو أصغر. يمكن استخدام رموز Plus Codes كبديل لعناوين الشوارع في الأماكن التي لا تتوفّر فيها (حيث لا يتم ترقيم المباني أو تسمية الشوارع). يمكنك الاطّلاع على Open Location Code وPlus Codes. يمكنك الاطّلاع على PlusCode لمزيد من المعلومات. |
|
اختياري | الرقم |
مستوى سعر المكان، على مقياس من 0 إلى 4 سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى. يتم تفسير مستويات الأسعار على النحو التالي:
|
|
اختياري | الرقم |
تحتوي هذه السمة على تقييم المكان، من 1.0 إلى 5.0، استنادًا إلى مراجعات المستخدمين المجمَّعة. |
|
اختياري | سلسلة | تم إيقاف |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يتيح الحجوزات. |
|
اختياري | Array<PlaceReview> |
مصفوفة JSON تتضمّن ما يصل إلى خمس مراجعات يتم ترتيب المراجعات تلقائيًا حسب مدى صلتها بموضوع البحث. استخدِم مَعلمة الطلب
تنصح Google بأن توضّح للمستخدمين ما إذا كانت النتائج مرتّبة حسب يمكنك الاطّلاع على PlaceReview للحصول على مزيد من المعلومات. |
|
اختياري | سلسلة | تم إيقاف |
|
اختياري | Array<PlaceOpeningHours> |
تحتوي على مصفوفة من الإدخالات للأيام السبعة التالية، بما في ذلك معلومات حول ساعات العمل الثانوية لنشاط تجاري. ساعات العمل الثانوية تختلف عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدّد مطعم ساعات عمل ثانوية، مثل ساعات خدمة السيارة أو ساعات التوصيل. يملأ هذا الحقل الحقل الفرعي يمكنك الاطّلاع على PlaceOpeningHours للحصول على مزيد من المعلومات. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم البيرة. |
|
اختياري | قيمة منطقية |
تحدِّد هذه السمة ما إذا كان المكان يقدّم وجبة الإفطار. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم وجبات الإفطار المتأخر. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم العشاء. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم الغداء. |
|
اختياري | قيمة منطقية |
تحدِّد ما إذا كان المكان يقدّم طعامًا نباتيًا. |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يقدّم النبيذ. |
|
اختياري | قيمة منطقية |
تحدِّد هذه السمة ما إذا كان النشاط التجاري يتيح خدمة استلام الطلبات. |
|
اختياري | Array<string> |
تحتوي على مصفوفة من أنواع الميزات التي تصف النتيجة المحدّدة. اطّلِع على قائمة الأنواع المتوافقة. |
|
اختياري | سلسلة |
يحتوي على عنوان URL الخاص بصفحة Google الرسمية لهذا المكان. ستكون هذه الصفحة مملوكة من Google وستتضمّن أفضل المعلومات المتاحة حول المكان. يجب أن تتضمّن التطبيقات رابطًا إلى هذه الصفحة أو أن تدمجها في أي شاشة تعرض نتائج تفصيلية حول المكان للمستخدم. |
|
اختياري | الرقم |
تمثّل هذه السمة إجمالي عدد المراجعات التي تتضمّن نصًا أو لا تتضمّنه لهذا المكان. |
|
اختياري | الرقم |
يحتوي على عدد الدقائق التي يختلف بها التوقيت الحالي لهذا المكان عن التوقيت العالمي المتفق عليه. على سبيل المثال، بالنسبة إلى الأماكن في سيدني، أستراليا، خلال نظام التوقيت الصيفي، سيكون هذا الرقم 660 (أي 11 ساعة إضافية عن التوقيت العالمي المتفق عليه)، وبالنسبة إلى الأماكن في كاليفورنيا خارج نظام التوقيت الصيفي، سيكون هذا الرقم 480- (أي 8 ساعات أقل من التوقيت العالمي المتفق عليه). |
|
اختياري | سلسلة |
بالنسبة إلى نتائج
بالنسبة إلى جميع النتائج الأخرى، يحتوي الحقل يجب قراءة هذا المحتوى كما هو، ويُرجى عدم تحليله آليًا. |
|
اختياري | سلسلة |
الموقع الإلكتروني الموثوق لهذا المكان، مثل الصفحة الرئيسية الخاصة بنشاط تجاري |
|
اختياري | قيمة منطقية |
تحدّد هذه السمة ما إذا كان المكان يتضمّن مدخلاً صالحًا للكراسي المتحركة. |
PlaceEditorialSummary
يحتوي على ملخّص عن المكان. يتألف الملخّص من نظرة عامة نصية، ويتضمّن أيضًا رمز اللغة إذا كان ذلك منطبقًا. يجب عرض النص الموجز كما هو، ولا يمكن تعديله أو تغييره.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري | سلسلة |
لغة الحقول السابقة قد لا تكون متوفّرة دائمًا. |
|
اختياري | سلسلة |
تمثّل هذه السمة ملخّصًا نصيًا متوسط الطول للمكان. |
PlaceOpeningHours
تمثّل هذه السمة وصف ساعات عمل مكان معيّن.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري | قيمة منطقية |
قيمة منطقية تشير إلى ما إذا كان المكان مفتوحًا في الوقت الحالي. |
|
اختياري | Array<PlaceOpeningHoursPeriod> |
مصفوفة من فترات العمل تغطي سبعة أيام، بدءًا من يوم الأحد، بالترتيب الزمني يمكنك الاطّلاع على PlaceOpeningHoursPeriod للحصول على مزيد من المعلومات. |
|
اختياري | Array<PlaceSpecialDay> |
مصفوفة تتضمّن ما يصل إلى سبعة إدخالات تتوافق مع الأيام السبعة التالية. يمكنك الاطّلاع على PlaceSpecialDay للحصول على مزيد من المعلومات. |
|
اختياري | سلسلة |
سلسلة نوع تُستخدَم لتحديد نوع الساعات الثانوية (على سبيل المثال، |
|
اختياري | Array<string> |
تمثّل هذه السمة مصفوفة من السلاسل النصية التي تصف ساعات عمل المكان بنص يمكن لشخص عادي قراءته. |
PlaceOpeningHoursPeriod
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | PlaceOpeningHoursPeriodDetail |
تحتوي هذه السمة على زوج من عناصر اليوم والوقت التي تصف وقت فتح المكان. لمزيد من المعلومات، اطّلِع على PlaceOpeningHoursPeriodDetail. |
|
اختياري | PlaceOpeningHoursPeriodDetail |
قد يحتوي على زوج من عناصر اليوم والوقت التي تصف وقت إغلاق المكان. إذا كان المكان مفتوحًا دائمًا، لن يظهر قسم الإغلاق في الرد. يمكن للعملاء الاعتماد على تمثيل حالة "مفتوح دائمًا" على أنّها فترة مفتوحة تتضمّن اليوم بالقيمة لمزيد من المعلومات، اطّلِع على PlaceOpeningHoursPeriodDetail. |
PlaceSpecialDay
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
اختياري | سلسلة |
تمثّل هذه السمة تاريخًا بالتنسيق RFC3339 في المنطقة الزمنية المحلية للمكان، مثلاً 2010-12-31. |
|
اختياري | قيمة منطقية |
تكون القيمة صحيحة إذا كانت هناك ساعات عمل استثنائية لهذا اليوم. إذا كانت القيمة |
PlaceOpeningHoursPeriodDetail
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | الرقم |
رقم من 0 إلى 6، يتوافق مع أيام الأسبوع، بدءًا من يوم الأحد. على سبيل المثال، يعني الرقم 2 يوم الثلاثاء. |
|
مطلوب | سلسلة |
قد يحتوي على وقت من اليوم بتنسيق hhmm على مدار 24 ساعة. تتراوح القيم بين 0000 و2359. سيتم تسجيل الوقت حسب المنطقة الزمنية للمكان. |
|
اختياري | سلسلة |
تمثّل هذه السمة تاريخًا بالتنسيق RFC3339 في المنطقة الزمنية المحلية للمكان، مثلاً 2010-12-31. |
|
اختياري | قيمة منطقية |
تكون القيمة صحيحة إذا تم اقتطاع فترة معيّنة بسبب حدّ أقصى يبلغ سبعة أيام، حيث تبدأ الفترة قبل منتصف الليل في تاريخ الطلب و/أو تنتهي في منتصف الليل أو بعده في اليوم الأخير. تشير هذه السمة إلى أنّ فترة فتح أو إغلاق المؤسسة يمكن أن تمتد إلى ما بعد هذا الحدّ الأقصى البالغ سبعة أيام. |
PlacePhoto
صورة لمكان يمكن الوصول إلى الصورة من خلال واجهة برمجة التطبيقات Place Photo باستخدام عنوان URL بالنمط التالي:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
يمكنك الاطّلاع على مقالة صور الأماكن للحصول على مزيد من المعلومات.
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | الرقم |
تمثّل هذه السمة ارتفاع الصورة. |
|
مطلوب | Array<string> |
إحالات HTML الخاصة بالصورة |
|
مطلوب | سلسلة |
سلسلة تُستخدَم لتحديد الصورة عند تنفيذ طلب Photo. |
|
مطلوب | الرقم |
تمثّل هذه السمة عرض الصورة. |
PlaceReview
مراجعة للمكان أرسلها أحد المستخدمين
| الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
|
مطلوب | سلسلة |
تمثّل هذه السمة اسم المستخدم الذي أرسل المراجعة. تُنسب المراجعات المجهولة المصدر إلى "أحد مستخدمي Google". |
|
مطلوب | الرقم |
التقييم العام الذي قدّمه المستخدم لهذا المكان. هذا العدد هو عدد صحيح يتراوح بين 1 و5. |
|
مطلوب | سلسلة |
تمثّل هذه السمة الوقت الذي تم فيه إرسال المراجعة كنص، وذلك بالنسبة إلى الوقت الحالي. |
|
مطلوب | الرقم |
الوقت الذي تم فيه إرسال المراجعة، ويُقاس بعدد الثواني منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المنسق. |
|
اختياري | سلسلة |
تمثّل هذه السمة عنوان URL للملف الشخصي للمستخدم في برنامج "المرشدون المحليون" على "خرائط Google"، إذا كان متاحًا. |
|
اختياري | سلسلة |
تمثّل هذه السمة رمز لغة IETF يشير إلى لغة المراجعة التي تم عرضها.يحتوي هذا الحقل على علامة اللغة الرئيسية فقط، وليس العلامة الثانوية التي تشير إلى البلد أو المنطقة. على سبيل المثال، يتم تصنيف جميع المراجعات باللغة الإنجليزية على أنّها "en"، وليس "en-AU" أو "en-UK" وما إلى ذلك.يكون هذا الحقل فارغًا إذا كان هناك تقييم فقط بدون نص مراجعة. |
|
اختياري | سلسلة |
تمثّل هذه السمة رمز لغة IETF يشير إلى اللغة الأصلية للمراجعة. إذا تمت ترجمة المراجعة، ستكون قيمة |
|
اختياري | سلسلة |
تمثّل هذه السمة عنوان URL الخاص بصورة الملف الشخصي للمستخدم، إذا كان ذلك متاحًا. |
|
اختياري | سلسلة |
مراجعة المستخدم عند مراجعة موقع جغرافي باستخدام Google Places،
تُعتبر المراجعات النصية اختيارية. لذلك، قد يكون هذا الحقل فارغًا. يُرجى العِلم أنّ هذا الحقل قد يتضمّن ترميز HTML بسيطًا. على سبيل المثال، قد يشير مرجع الكيان |
|
اختياري | قيمة منطقية |
قيمة منطقية تشير إلى ما إذا تمت ترجمة المراجعة من اللغة الأصلية التي كُتبت بها.إذا تمت ترجمة المراجعة، أي إذا كانت القيمة المقابلة هي "صحيح"، تنصحك Google بالإشارة إلى ذلك للمستخدمين. على سبيل المثال، يمكنك إضافة السلسلة التالية "ترجمة Google" إلى المراجعة. |
الوصول إلى نتائج إضافية
يتم تلقائيًا عرض ما يصل إلى 20 establishment نتيجة
في كل ردّ على طلب بحث، ولكن يمكن أن يعرض كل بحث ما يصل إلى 60 نتيجة مقسّمة على ثلاث صفحات. إذا كان البحث سيعرض أكثر من 20 نتيجة، سيتضمّن رد البحث قيمة إضافية، وهي next_page_token. مرِّر قيمة next_page_token إلى المَعلمة pagetoken في طلب جديد للاطّلاع على المجموعة التالية من النتائج.
- إذا كانت قيمة
next_page_tokenفارغة أو لم يتم عرضها، لن تظهر أي نتائج أخرى. - ستؤدي إعادة محاولة الطلب باستخدام
next_page_tokenنفسه إلى عرض الصفحة التالية من النتائج. - سيؤدي ضبط
pagetokenإلى تجاهل أي معلّمات أخرى. - يمكنك طلب صفحة جديدة مرتين كحد أقصى بعد طلب البحث الأصلي.
- يُحتسب كل طلب، بما في ذلك الطلب الذي يستخدم
next_page_token، كطلب واحد ضمن حدود الاستخدام ويتم تحصيل رسوم منه بشكل منفصل. - هناك تأخير لبضع ثوانٍ بين وقت إصدار
next_page_tokenووقت أن يصبح صالحًا. سيؤدي طلب الصفحة التالية قبل توفّرها إلى عرض استجابةINVALID_REQUEST. يتم دائمًا تحصيل رسوم مقابل الطلبات التي تتضمّنnext_page_token.
على سبيل المثال، في طلب البحث أدناه، نبحث عن مطاعم بالقرب من "ميناء دارلينغ" في سيدني، أستراليا، ونرتّب النتائج حسب المسافة. يمكنك أن ترى أنّ الردّ يتضمّن السمة next_page_token.
{
"html_attributions" : [],
"next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
"results" : [...]
"status" : "OK"
}للاطّلاع على المجموعة التالية من النتائج، يمكنك إرسال طلب بحث جديد مع تمرير نتيجة next_page_token إلى المَعلمة pagetoken. على سبيل المثال:
https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY