รหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน ระบบยอมรับรหัสสถานที่ในคำขอไปยัง Maps API ต่อไปนี้
- การดึงข้อมูลที่อยู่สำหรับรหัสสถานที่ในบริการบนเว็บ Geocoding API และบริการ Geocoding, Maps JavaScript API
- การระบุจุดอ้างอิงต้นทาง จุดหมาย และจุดอ้างอิงระหว่างกลางใน บริการเว็บ Routes API และ Directions API และบริการ Directions API ของ Maps JavaScript API
- การระบุต้นทางและปลายทางใน Routes API และ บริการเว็บ Distance Matrix API และ บริการ Distance Matrix Service, Maps JavaScript API
- การเรียกดูรายละเอียดสถานที่ในบริการเว็บ Places API, Places SDK สำหรับ Android, Places SDK สำหรับ iOS และห้องสมุด Places
- การใช้พารามิเตอร์รหัสสถานที่ใน Maps Embed API
- กำลังเรียกคำค้นหาใน URL ของ Maps
- กำลังแสดงการจำกัดความเร็วใน Roads API
- การค้นหาและจัดรูปแบบรูปหลายเหลี่ยมขอบเขตในการจัดรูปแบบตามข้อมูลสำหรับขอบเขต
ค้นหารหัสของสถานที่ที่เจาะจง
คุณกำลังมองหารหัสสถานที่ของสถานที่หนึ่งๆ หรือไม่ ใช้เครื่องมือค้นหารหัสสถานที่ด้านล่างเพื่อค้นหาสถานที่และดูรหัสของสถานที่
หรือจะดูตัวค้นหารหัสสถานที่โดยใช้โค้ดในเอกสารของ Maps JavaScript API ก็ได้
ภาพรวม
รหัสสถานที่คือตัวระบุแบบข้อความที่ระบุสถานที่แต่ละแห่งโดยไม่ซ้ำกัน ความยาวของตัวระบุอาจแตกต่างกันไป (ไม่มีความยาวสูงสุดสำหรับรหัสสถานที่) ตัวอย่าง
-
ChIJgUbEo8cfqokR5lP9_Wh_DaM
-
GhIJQWDl0CIeQUARxks3icF8U8A
-
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
-
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
-
IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ
รหัสสถานที่ใช้ได้กับสถานที่ส่วนใหญ่ รวมถึงธุรกิจ จุดสังเกต สวนสาธารณะ และทางแยก สถานที่หรือสถานที่เดียวกันอาจมีรหัสสถานที่ที่แตกต่างกันหลายรหัส รหัสสถานที่อาจเปลี่ยนแปลงเมื่อเวลาผ่านไป
คุณใช้รหัสสถานที่เดียวกันใน Places API และ Google Maps Platform API จํานวนหนึ่งได้ ตัวอย่างเช่น คุณสามารถใช้รหัสสถานที่เดียวกันเพื่ออ้างอิงสถานที่ใน Places API, Maps JavaScript API, Geocoding API, Maps Embed API และ Roads API
ดึงข้อมูลรายละเอียดสถานที่โดยใช้รหัสสถานที่
โดยทั่วไปแล้ว การใช้รหัสสถานที่คือการค้นหาสถานที่ (โดยใช้ Places API หรือไลบรารีสถานที่ใน Maps JavaScript API เป็นต้น) แล้วใช้รหัสสถานที่ที่ส่งกลับเพื่อเรียกดูรายละเอียดสถานที่ คุณจัดเก็บรหัสสถานที่และใช้รหัสดังกล่าวเพื่อเรียกดูรายละเอียดสถานที่เดียวกันในภายหลังได้ ดูข้อมูลเกี่ยวกับการบันทึกรหัสสถานที่ด้านล่าง
ตัวอย่างต่อไปนี้แสดงวิธีขอ URL ของไอคอนสำหรับ Places API (ใหม่) และ Places API
Places API (ใหม่)
คุณใช้ Places API เพื่อค้นหารหัสสถานที่ได้โดยการส่งคำขอค้นหาข้อความ (ใหม่)
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
คำตอบจะมีรหัสสถานที่ในช่อง id
ตามที่แสดงด้านล่าง
{ "places": [ { "id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0", "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... }
ตอนนี้คุณสามารถส่งคำขอรายละเอียดสถานที่ (ใหม่) ได้แล้วโดยการใส่รหัสสถานที่ไว้ใน URL คำขอ ดังนี้
https://places.googleapis.com/v1/places/ChIJs5ydyTiuEmsR0fRSlU0C7k0?fields=id,displayName&key=API_KEY
Places API
คุณสามารถค้นหารหัสสถานที่ได้โดยใช้ Places API โดยส่งคำขอ Place Search
ตัวอย่างต่อไปนี้คือคำขอค้นหาสถานที่ประเภท "ร้านอาหาร" ภายในรัศมี 1,500 ม. จากจุดในซิดนีย์ ออสเตรเลีย ที่มีคำว่า "เรือสำราญ"
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY
การตอบกลับจะมีรหัสสถานที่ในช่อง place_id
ดังที่แสดงในข้อมูลโค้ดนี้
{ "html_attributions" : [], "results" : [ { "geometry" : { "location" : { "lat" : -33.870775, "lng" : 151.199025 } }, ... "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0", ... } ], "status" : "OK" }
ตอนนี้คุณสามารถส่งคำขอรายละเอียดสถานที่ โดยใส่รหัสสถานที่ในพารามิเตอร์ place_id
ดังนี้
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY
บันทึกรหัสสถานที่ไว้ใช้ภายหลัง
รหัสสถานที่ได้รับการยกเว้นจากข้อจำกัดการแคชที่ระบุไว้ในส่วนที่ 3.2.3(ข) ของข้อกำหนดในการให้บริการของ Google Maps Platform คุณจึงสามารถจัดเก็บค่ารหัสสถานที่ไว้ใช้ในภายหลังได้
กำลังรีเฟรชรหัสสถานที่ที่จัดเก็บไว้
เราขอแนะนำให้รีเฟรชรหัสสถานที่หากมีอายุเกิน 12 เดือน คุณรีเฟรชรหัสสถานที่ได้โดยไม่มีค่าใช้จ่าย โดยส่งคำขอรายละเอียดสถานที่ โดยระบุเฉพาะช่องรหัสสถานที่ในพารามิเตอร์ fields
Places API (ใหม่)
ตัวอย่างเช่น เมื่อใช้รายละเอียดสถานที่ (ใหม่) ให้ทำดังนี้
https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY
Places API
ตัวอย่างเช่น ใช้ Place Details API เดิม
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY
คำขอนี้อาจแสดงรหัสสถานะ NOT_FOUND
ด้วย กลยุทธ์หนึ่งคือการจัดเก็บคำขอเดิมที่แสดงผลรหัสสถานที่แต่ละแห่ง หากรหัสสถานที่ไม่ถูกต้อง คุณสามารถออกคำขอนั้นอีกครั้งเพื่อให้ได้ผลการค้นหาใหม่ ผลการค้นหาเหล่านี้อาจรวมสถานที่ต้นฉบับหรือไม่ก็ได้ อย่างไรก็ตาม คำขอนี้เรียกเก็บเงินได้
รหัสข้อผิดพลาดเมื่อใช้รหัสสถานที่
รหัสสถานะ INVALID_REQUEST
ระบุว่ารหัสสถานที่ที่ระบุไม่ถูกต้อง ระบบอาจแสดงผล INVALID_REQUEST
เมื่อรหัสสถานที่ถูกตัดหรือมีการแก้ไข ซึ่งไม่ถูกต้องอีกต่อไป
รหัสสถานะ NOT_FOUND
บ่งบอกว่ารหัสสถานที่ที่ระบุล้าสมัย รหัสสถานที่อาจล้าสมัยหากธุรกิจปิดหรือย้ายไปยัง
สถานที่ตั้งใหม่ รหัสสถานที่อาจมีการเปลี่ยนแปลงเนื่องจากมีการอัปเดตจำนวนมากในฐานข้อมูล Google Maps ในกรณีดังกล่าว สถานที่อาจได้รับรหัสสถานที่ใหม่ และรหัสเก่าจะส่งการตอบกลับ NOT_FOUND
โดยเฉพาะอย่างยิ่ง รหัสสถานที่บางประเภทอาจทำให้การตอบสนองของ NOT_FOUND
เป็นบางครั้ง หรือ API อาจแสดงรหัสสถานที่อื่นในการตอบกลับ ประเภทรหัสสถานที่เหล่านี้ ได้แก่
- ที่อยู่ที่ไม่มีอยู่ใน Google Maps ว่าเป็นที่อยู่ที่แน่นอน แต่อนุมานจากช่วงของที่อยู่
- ส่วนของเส้นทางยาวๆ ที่คำขอระบุเมืองหรือย่านด้วย
- ทางแยก
- สถานที่ที่มีองค์ประกอบที่อยู่ประเภท
subpremise
รหัสเหล่านี้มักอยู่ในรูปแบบสตริงขนาดยาว (ไม่มีความยาวสูงสุดสำหรับรหัสสถานที่) เช่น
EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4