800,000 個以上興趣點
全台自有興趣點圖資，含名稱、完整地址與座標；選定之後再用 Place Details 取電話、營業時間、網站與照片。
拉麵⏎ 送出
- 屯京拉麵 台北站前店
- 太陽蕃茄拉麵 站前本店
- 明拉麵Ramen Bar
- 屯京拉麵 中山店
名稱與 place_id ・ 每一鍵回一次
1一風堂 台北車站店
- formatted_address
- 台北市中正區北平西路3號2樓
- geometry.location
- 25.047924, 121.517081
- kw_extra.category_name
- 拉麵店
2明拉麵Ramen Bar
3太陽蕃茄拉麵 站前本店
4屯京拉麵 台北站前店
5花月嵐 台北凱撒店
每一筆帶地址、座標與 kw_extra ・ 單次最多 20 筆
- 還在打 ・ Autocomplete
- 已送出 ・ Places
Also here
已經有地址的時候
上面兩支處理的是「使用者想找什麼」。如果你手上已經是一行地址 —— 訂單的收件地址、工單的現場位置 —— 要的其實是把它換成座標。
地址與座標互轉
Geocoding
同一條端點兩個方向：帶 Address 回座標，帶 LatLng 回地址。回應會標出這一筆定位到多準， 要再嚴格一點還有 Geocode Advanced 回正規化地址與定位層級。
How to choose
如何選擇使用哪個產品
兩支不是取代關係，一個正式的搜尋框通常兩支都要 ——
打字時用 Autocomplete，使用者不選建議直接送出時才用 Places。
- 搜尋框要邊打邊給建議Autocomplete回得很薄，來得及跟上按鍵
- 使用者按下 Enter 才查Places一次拿完，最多 20 筆
- 要把結果標在自己的地圖上Places每一筆都帶 geometry.location
- 選定之後要電話與營業時間Place Details拿 place_id 再打一次
- 手上已經是一行地址Geocoding換成座標，或反過來換回地址
Same data
同一份地點資料
兩支查的是同一份自有圖資，所以下拉選單裡看到的那一筆， 送出之後拿到的就是同一個地點。
中文細分類
通用的 types 之外，kw_extra.category_name 另給一層中文細分類 ——「拉麵店」「汽車地下停車場」，可以直接當標籤顯示。
同一份類型表
兩支吃的是同一份 Type List，只是能給幾個不同：Autocomplete 的 Types 可用 | 串最多五種，TextSearch 的 Type 一次一種。