Nearby Search (舊版) 可讓您搜尋指定區域內的地點。您可以提供關鍵字或指定要搜尋的地點類型,進一步調整搜尋要求。
Nearby Search (舊版) 要求
Nearby Search (舊版) 要求是下列形式的 HTTP 網址:
https://maps.googleapis.com/maps/api/place/nearbysearch/output?parameters
其中 output 可以是下列任一值:
json(建議使用) 表示以 JavaScript 物件標記法 (JSON) 輸出xml表示輸出內容為 XML
如要發出「Nearby Search」(舊版) 要求,必須提供特定參數。依照網址標準,所有參數都會以 & 字元分隔。
必要參數
-
位置
用於擷取地點資訊的點。這必須指定為
latitude,longitude。 -
半徑
定義要傳回地點結果的距離 (以公尺為單位)。您可以傳送
location和radius參數,針對特定圓形範圍調整結果。這樣就能指示地點介面集服務優先顯示該圓形範圍內的結果,不過系統還是有可能會顯示定義區域外的結果。系統會根據搜尋類型和其他參數,自動將半徑限制在最大值內。
- 自動完成:50,000 公尺
-
Nearby Search:
- 使用
keyword或name:50,000 公尺 -
不含
keyword或name-
最多 50,000 公尺,會根據區域密度動態調整,不受
rankby參數影響。 -
使用
rankby=distance時,系統不會接受半徑參數,並會導致INVALID_REQUEST。
-
最多 50,000 公尺,會根據區域密度動態調整,不受
- 使用
- Query Autocomplete:50,000 公尺
- Text Search:50,000 公尺
選用參數
-
關鍵字
要搜尋的文字字串,例如「餐廳」或「中正路 123 號」。這必須是地點名稱、位址或建築物類別。任何其他類型的輸入內容都可能會產生錯誤,不保證會傳回有效的結果。Google 地點服務會根據這個字串傳回候選相符項目,並會依據觀察到的關聯性排序結果。
使用這項參數明確加入位置資訊,可能會與位置、半徑和 rankby 參數衝突,導致出現非預期結果。
如果省略這個參數,系統就不會傳回 business_status 為 CLOSED_TEMPORARILY 或 CLOSED_PERMANENTLY 的地點。
-
language
傳回結果時使用的語言。
- 查看支援語言清單。Google 會經常更新支援的語言,因此這份清單可能不完整。
-
如果未提供
language,API 會嘗試使用Accept-Language標頭中指定的偏好語言。 - API 會盡量提供使用者和當地人都能辨識的街道地址。為達成這個目標,系統會以當地語言傳回街道地址,並視需要根據偏好語言,將地址音譯為使用者可讀取的文字。所有其他地址都會以偏好語言顯示。地址元件一律會以同一種語言傳回,而該語言是從第一個元件中選擇。
- 如果偏好語言沒有名稱,API 會使用最接近的名稱。
- 偏好語言對 API 選擇傳回的結果集和傳回順序影響不大。地理編碼器會根據語言解讀縮寫,例如街道類型縮寫,或在某種語言中有效但在另一種語言中無效的同義字。舉例來說,utca 和 tér 是匈牙利文的街道同義詞。
-
maxprice
限制系統只傳回指定範圍內的結果。有效值介於 0 (最便宜) 和 4 (最昂貴),含首尾兩值。特定值所代表的確切金額會因地區而異。
-
minprice
限制系統只傳回指定範圍內的結果。有效值介於 0 (最便宜) 和 4 (最昂貴),含首尾兩值。特定值所代表的確切金額會因地區而異。
-
名稱
等同於
keyword。這個欄位的值會與keyword欄位的值合併,並做為同一個搜尋字串的一部分傳送。 -
opennow
只會傳回在查詢當下營業中的地點。如果您在查詢中加入這個參數,系統就不會傳回未於 Google 地點介面集資料庫中指定營業時間的地點。
-
pagetoken
傳回先前執行搜尋作業的最多 20 個結果。設定
pagetoken參數會使用先前使用的相同參數執行搜尋,系統會忽略 pagetoken 以外的所有參數。 -
rankby
指定結果的列出順序。可能的值為:
-
prominence(預設)。這個選項會根據重要性排列結果。系統會優先列出指定半徑範圍內的知名地點,而非相符但較不知名的附近地點。知名度可能會受到 Google 索引中的地點排名、全球熱門程度和其他因素影響。指定顯著性時,必須提供radius參數。 -
distance。這個選項會根據地點與指定位置之間的距離,以遞增順序排列搜尋結果。如果指定distance,則必須提供一或多個keyword、name或type,且不允許radius。
-
-
類型
讓系統在結果中只顯示符合指定類型的地點。只能指定一個類型。如果提供多種類型,系統會忽略第一種類型之後輸入的所有類型。
-
type=hospital|pharmacy|doctor會變成type=hospital - 系統會完全忽略
type=hospital,pharmacy,doctor
請參閱支援類型清單。
注意:如果同時新增keyword和type,且兩者值相同 (keyword=cafe&type=cafe或keyword=parking&type=parking),則可能會產生ZERO_RESULTS。 -
Nearby Search (舊版) 範例
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 替換成自己的 API 金鑰,要求才能在應用程式中運作。
Nearby Search (舊版) 回應
以下範例顯示Nearby Search (舊版) 回應。
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
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 陣列<字串> |
可能包含一組關於這個商家資訊的出處資訊,必須向使用者顯示 (部分商家資訊可能沒有出處資訊)。 |
|
required | 陣列<Place> |
包含地點陣列。
Place Search 要求會傳回 Place Details 要求傳回的部分欄位。如果 Place Search 沒有傳回所需的欄位,您可以使用 Place Search 取得
place_id,然後使用該地點 ID 提出 Place Details 要求。詳情請參閱「地點」。 |
|
required | PlacesSearchStatus |
內含要求的狀態,還可能包含偵錯資訊,方便您追查要求失敗的原因。 詳情請參閱 PlacesSearchStatus。 |
|
選用 | 字串 |
如果服務傳回的狀態碼不是 |
|
選用 | 陣列<字串> |
如果服務傳回要求規格的額外資訊,回應物件中可能會有額外的 |
|
選用 | 字串 |
內含可用於傳回最多 20 個額外結果的符記。如果沒有其他結果可顯示,系統就不會傳回 next_page_token。最多可傳回 60 個結果。系統發出 next_page_token 後,會經過一小段時間才會生效。 |
PlacesSearchStatus
服務傳回的狀態碼。
OK:表示 API 要求成功。-
ZERO_RESULTS表示搜尋成功,但未傳回任何結果。如果搜尋傳遞至遠端位置的latlng,就可能發生這種情況。 -
INVALID_REQUEST:表示 API 要求格式有誤,通常是因為缺少必要查詢參數 (location或radius)。 -
OVER_QUERY_LIMIT,表示下列任一情況:- 您已超過每秒查詢次數限制。
- 您的帳戶尚未啟用帳單功能。
- 超過每月 $200 美元的抵免額或自行設定的用量上限。
- 您提供的付款方式已失效 (例如信用卡已過期)。
-
REQUEST_DENIED:表示您的要求遭拒,一般是因為:- 要求缺少 API 金鑰。
- 「
key」參數無效。
UNKNOWN_ERROR:表示發生未知錯誤。
地點
描述地點的屬性。並非所有屬性都適用於所有地點類型。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
選用 | Array<AddressComponent> |
這個陣列包含這個地址適用的各種元件。 詳情請參閱 AddressComponent。 |
|
選用 | 字串 |
以 adr 微格式表示地點地址。 |
|
選用 | 字串 |
表示地點的營業狀態 (如果地點為商家)。
如果沒有任何資料,則不會傳回
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
選用 | 布林值 |
指定商家是否支援路邊取餐。 |
|
選用 | PlaceOpeningHours |
包含接下來七天 (包括今天) 的營業時間。時間範圍從要求當天的午夜開始,並在六天後的晚上 11:59 結束。這個欄位包含所有時段的 詳情請參閱 PlaceOpeningHours。 |
|
選用 | 布林值 |
指定商家是否支援外送。 |
|
選用 | 布林值 |
指定商家是否提供室內或戶外雅座選項。 |
|
選用 | PlaceEditorialSummary |
含有地點摘要。摘要包含文字總覽,以及適用的語言代碼。摘要文字必須照實呈現,不得修改或變更。 詳情請參閱 PlaceEditorialSummary。 |
|
選用 | 字串 |
字串,內含這個地點的人類可讀地址。 這個地址通常等於郵寄地址。請注意,由於授權上的限制,部分國家/地區 (例如英國) 不允許散布真實的郵寄地址。 格式化地址在邏輯上是由一或多個地址元件組成。舉例來說,「111 8th Avenue, New York, NY」這個地址包含以下元件:「111」(門牌號碼)、「8th Avenue」(路名)、「New York」(城市) 和「NY」(美國州名)。 請勿以程式輔助方式剖析格式化地址。建議您改用個別地址元件,API 回應除了包含格式化地址欄位之外,也會包含這些元件。 |
|
選用 | 字串 |
包含地點的電話號碼 (當地格式)。 |
|
選用 | 幾何學 |
內含地點的位置和可視區域。 詳情請參閱「幾何圖形」。 |
|
選用 | 字串 |
包含建議圖示的網址,在使用者於地圖上指出這項結果時,系統可能會向使用者顯示該圖示。 |
|
選用 | 字串 |
包含地點類別的預設十六進位顏色代碼。 |
|
選用 | 字串 |
包含建議圖示的網址,刪除 |
|
選用 | 字串 |
包含地點的電話號碼 (國際電話號碼格式)。國際電話號碼格式包含國碼,且前置字元為加號 (+)。舉例來說,Google 澳洲雪梨辦公室的 international_phone_number 為 |
|
選用 | 字串 |
包含傳回結果的使用者可解讀名稱。如果是 |
|
選用 | PlaceOpeningHours |
包含一般營業時間。 詳情請參閱 PlaceOpeningHours。 |
|
選用 | 布林值 |
使用 |
|
選用 | 陣列<PlacePhoto> |
相片物件陣列,每個物件都包含圖片的參照。要求最多可傳回十張相片。如要進一步瞭解地點相片,以及如何在應用程式中使用這些圖片,請參閱「地點相片」說明文件。 詳情請參閱 PlacePhoto。 |
|
選用 | 字串 |
用來識別特定地點的文字 ID,如要擷取地點資訊,請在 Places API 要求的 |
|
選用 | PlusCode |
經過編碼的位置參照,衍生自經緯度座標,表示面積不超過 1/8000 度 x 1/8000 度 (在赤道區約 14 公尺 x 14 公尺) 的區域。對於沒有詳細地址的地點,Plus Codes 可用於取代街道地址,例如無編號的建築物或無名街道。請參閱「開放式位置代碼」和「Plus Codes」。 詳情請參閱 PlusCode。 |
|
選用 | 數字 |
地點的價格等級,範圍為 0 到 4。特定值所代表的確切金額會因地區而異。價格等級的解讀方式如下:
|
|
選用 | 數字 |
包含地點評分 (1.0 到 5.0,根據綜合使用者評論計算)。 |
|
選用 | 字串 | |
|
選用 | 布林值 |
指定地點是否支援訂位。 |
|
選用 | Array<PlaceReview> |
最多包含 5 則評論的 JSON 陣列。評論預設會依關聯性排序。使用
Google 建議向使用者說明結果是否依 詳情請參閱 PlaceReview。 |
|
選用 | 字串 | |
|
選用 | Array<PlaceOpeningHours> |
包含未來七天的項目陣列,包括商家次要營業時間的相關資訊。次要營業時間與商家的主要營業時間不同。舉例來說,餐廳可以將得來速或外送時間指定為次要營業時間。這個欄位會填入 詳情請參閱 PlaceOpeningHours。 |
|
選用 | 布林值 |
指定地點是否供應啤酒。 |
|
選用 | 布林值 |
指定該場所是否供應早餐。 |
|
選用 | 布林值 |
指定地點是否供應早午餐。 |
|
選用 | 布林值 |
指定該場所是否供應晚餐。 |
|
選用 | 布林值 |
指定商家是否供應午餐。 |
|
選用 | 布林值 |
指定該場所是否供應素食餐點。 |
|
選用 | 布林值 |
指定地點是否供應葡萄酒。 |
|
選用 | 布林值 |
指出商家是否支援外帶。 |
|
選用 | 陣列<字串> |
包含描述指定結果的特徵類型陣列。請參閱支援類型清單。 |
|
選用 | 字串 |
包含這個地點的官方 Google 頁面網址。這是 Google 自有的頁面,內含該地點的實用資訊。在向使用者顯示地點詳細結果的任何畫面上,應用程式必須連結或嵌入這個頁面。 |
|
選用 | 數字 |
這個地點的評論總數 (無論是否包含文字)。 |
|
選用 | 數字 |
這個地點目前時區與世界標準時間的時差 (以分鐘為單位)。舉例來說,如果地點位於澳洲雪梨,且正值日光節約時間,則為 660 (比世界標準時間快 11 小時);如果地點位於加州,且非日光節約時間,則為 -480 (比世界標準時間慢 8 小時)。 |
|
選用 | 字串 |
如果是場所 (
對於所有其他結果, 這類內容應按原樣讀取。請勿以程式輔助方式剖析格式化地址。 |
|
選用 | 字串 |
這個地點的官方網站,例如商家的首頁。 |
|
選用 | 布林值 |
指定該地點是否設有無障礙入口。 |
PlaceEditorialSummary
含有地點摘要。摘要包含文字總覽,以及這些文字的語言代碼 (如適用)。摘要文字必須照實呈現,不得修改或變更。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
選用 | 字串 |
前幾個欄位的語言。不一定會顯示。 |
|
選用 | 字串 |
地點的文字摘要,長度適中。 |
PlaceOpeningHours
說明地點營業時間的物件。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
選用 | 布林值 |
布林值,指出地點目前是否營業中。 |
|
選用 | Array<PlaceOpeningHoursPeriod> |
涵蓋 7 天的營業時段陣列,從週日開始,按時間順序排列。 詳情請參閱「PlaceOpeningHoursPeriod」。 |
|
選用 | Array<PlaceSpecialDay> |
最多七個項目的陣列,對應未來七天。 詳情請參閱 PlaceSpecialDay。 |
|
選用 | 字串 |
用來識別次要營業時間類型的類型字串 (例如 |
|
選用 | 陣列<字串> |
這個地點的營業時間,以使用者容易理解的文字表示。 |
PlaceOpeningHoursPeriod
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | PlaceOpeningHoursPeriodDetail |
包含一組日期和時間物件,用來描述地點的營業時間。 |
|
選用 | PlaceOpeningHoursPeriodDetail |
可能包含一組日期和時間物件,用來描述地點的休息時間。如果地點全年無休,回應中會缺少「關閉」部分。如果用戶端要表示「全年無休」,可以將營業時間設為包含值為 |
PlaceSpecialDay
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
選用 | 字串 |
以 RFC3339 格式表示的日期,時區為地點的當地時區,例如 2010-12-31。 |
|
選用 | 布林值 |
如果當天有特殊營業時間,則為 True。如果
|
PlaceOpeningHoursPeriodDetail
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 數字 |
從 0 到 6 之間的數字,分別代表星期幾 (以週日做為每週起始日)。例如,2 表示週二。 |
|
required | 字串 |
可能包含 24 小時 hhmm 格式的時間。值必須介於 0000 到 2359 之間。系統回報的時間是以地點的時區為準。 |
|
選用 | 字串 |
以 RFC3339 格式表示的日期,時區為地點的當地時區,例如 2010-12-31。 |
|
選用 | 布林值 |
如果指定時間範圍因七天截斷而遭到截斷,且該時間範圍的開始時間早於要求日期的午夜,和/或結束時間在最後一天的午夜或之後,則為 True。這項屬性表示開放或關閉的期限可超過七天截斷時間。 |
PlacePhoto
地點的相片。您可以使用下列模式的網址,透過 Place Photo API 存取相片:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
詳情請參閱「地點相片」。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 數字 |
相片的高度。 |
|
required | 陣列<字串> |
相片的 HTML 來源資訊。 |
|
required | 字串 |
執行相片要求時,用來識別相片的字串。 |
|
required | 數字 |
相片的寬度。 |
PlaceReview
使用者提交的地點評論。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 字串 |
提交評論的使用者名稱。匿名評論會歸類為「Google 使用者」。 |
|
required | 數字 |
使用者給予這個地點的整體評分 (從 1 到 5 的整數)。 |
|
required | 字串 |
以文字形式顯示評論提交時間,相對於目前時間。 |
|
required | 數字 |
評論提交時間,以自世界標準時間 1970 年 1 月 1 日午夜起算的時間 (秒) 為單位。 |
|
選用 | 字串 |
使用者 Google 地圖在地嚮導個人資料的網址 (如有)。 |
|
選用 | 字串 |
網際網路工程任務組 (IETF) 語言代碼,指出傳回評論的語言。這個欄位只包含主要語言標記,不含表示國家/地區或區域的次要標記。舉例來說,所有英文評論都會標示為「en」,而非「en-AU」或「en-UK」等等。如果只有評分而沒有評論文字,這個欄位會是空白。 |
|
選用 | 字串 |
網際網路工程任務組 (IETF) 語言代碼,指出評論的原始語言。如果評論經過翻譯,則 |
|
選用 | 字串 |
使用者個人資料相片的網址 (如有)。 |
|
選用 | 字串 |
使用者的評論。在 Google Places 介面集中評論地點時,使用者不一定要填寫文字評論,因此這個欄位可能會空白。請注意,這個欄位可能包含簡單的 HTML 標記。例如,實體參照 |
|
選用 | 布林值 |
布林值,指出評論是否從原始語言翻譯而來。如果評論經過翻譯 (對應的值為 true),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