Geocoder

Geocoder คลาส

google.maps.Geocoder คลาส

บริการสําหรับการแปลงระหว่างที่อยู่และ LatLng

เข้าถึงได้โดยโทรหา const {Geocoder} = await google.maps.importLibrary("geocoding") โปรดดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
Geocoder	Geocoder() พารามิเตอร์: ไม่มี สร้างอินสแตนซ์ใหม่ของ Geocoder ที่ส่งคําขอไวลด์การ์ดไปยังเซิร์ฟเวอร์ของ Google

วิธีการ
geocode	geocode(request[, callback]) พารามิเตอร์:  request:  GeocoderRequest callback:  function(Array<GeocoderResult> optional, GeocoderStatus): void optional แสดงผลค่า:  Promise<GeocoderResponse> คําขอข้อมูลพิกัดภูมิศาสตร์

อินเทอร์เฟซ GeocoderRequest

อินเทอร์เฟซ google.maps.GeocoderRequest

ข้อกําหนดของคําขอการเข้ารหัสตามภูมิศาสตร์ที่จะส่งไปยัง Geocoder

พร็อพเพอร์ตี้
address optional	ประเภท:  string optional ที่อยู่ที่จะใช้ป้อนภูมิศาสตร์ ต้องระบุ 1 รายการเท่านั้น, ของ address, location และ placeId 1 รายการเท่านั้น
bounds optional	ประเภท:  LatLngBounds|LatLngBoundsLiteral optional LatLngBounds ที่จะใช้ค้นหา ไม่บังคับ
componentRestrictions optional	ประเภท:  GeocoderComponentRestrictions optional คอมโพเนนต์ใช้เพื่อจํากัดผลลัพธ์ให้กับพื้นที่ที่เจาะจง ตัวกรองประกอบด้วย route, locality, administrativeArea, postalCode, country โดยจะแสดงเฉพาะผลลัพธ์ที่ตรงกับตัวกรองทั้งหมดเท่านั้น ค่าตัวกรองรองรับวิธีการแก้ไขตัวสะกดและการจับคู่บางส่วนเช่นเดียวกับคําขอการเขียนโค้ดตามภูมิศาสตร์อื่นๆ ไม่บังคับ
language optional	ประเภท:  string optional ตัวระบุภาษาที่ควรใช้แสดงผลการค้นหา ดูรายการภาษาที่รองรับ
location optional	ประเภท:  LatLng|LatLngLiteral optional LatLng (หรือ LatLngLiteral) ที่จะค้นหา โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะเข้ารหัสแบบย้อนกลับ ดูข้อมูลเพิ่มเติมได้ที่ การเข้ารหัสพิกัดย้อนกลับ ต้องระบุ 1 รายการเท่านั้น, ของ address, location และ placeId 1 รายการเท่านั้น
placeId optional	ประเภท:  string optional รหัสสถานที่ที่เชื่อมโยงกับสถานที่ตั้ง รหัสสถานที่จะระบุสถานที่ในฐานข้อมูลของ Google Places และใน Google Maps โดยไม่ซ้ํา ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ในคู่มือนักพัฒนาซอฟต์แวร์ Places API โปรแกรมเข้ารหัสพิกัดภูมิศาสตร์จะเข้ารหัสแบบย้อนกลับ ดูข้อมูลเพิ่มเติมที่การเข้ารหัสพื้นที่ย้อนกลับ ต้องระบุ 1 รายการเท่านั้น, ของ address, location และ placeId 1 รายการเท่านั้น
region optional	ประเภท:  string optional รหัสประเทศที่ใช้เพื่อการให้น้ําหนักการค้นหา โดยระบุเป็นแท็กย่อย Unicode แบบ 2 อักขระ (ไม่ใช่ตัวเลข) / ตัวระบุ CLDR ไม่บังคับ ดูรายละเอียดความครอบคลุมของ Google Maps Platform สําหรับภูมิภาคที่รองรับ

อินเทอร์เฟซ GeocoderElementRestrictions

อินเทอร์เฟซ google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions คือชุดตัวกรองที่ลิงก์ไปยังพื้นที่เฉพาะ โปรดดูรายละเอียดวิธีการทํางานที่หัวข้อ การกรองคอมโพเนนต์ทางภูมิศาสตร์

พร็อพเพอร์ตี้
administrativeArea optional	ประเภท:  string optional จับคู่administrative_area levelsทั้งหมด ไม่บังคับ
country optional	ประเภท:  string optional จับคู่ชื่อประเทศหรือรหัสประเทศ ISO 3166-1 สองตัวอักษร ไม่บังคับ
locality optional	ประเภท:  string optional จับคู่กับประเภท locality และ sublocality ไม่บังคับ
postalCode optional	ประเภท:  string optional ตรงกัน postal_code และ postal_code_prefix ไม่บังคับ
route optional	ประเภท:  string optional จับคู่ชื่อที่ยาวหรือสั้นของ route ไม่บังคับ

GeocoderStatus ค่าคงที่

google.maps.GeocoderStatus ค่าคงที่

สถานะส่งคืนโดย Geocoder เมื่อเสร็จสิ้นการโทรไปยัง geocode() ระบุค่าตามค่าเหล่านี้ หรือใช้ชื่อค่าคงที่ เช่น 'OK' หรือ google.maps.GeocoderStatus.OK

เข้าถึงได้โดยโทรหา const {GeocoderStatus} = await google.maps.importLibrary("geocoding") โปรดดูไลบรารีใน Maps JavaScript API

ค่าคงที่
ERROR	เกิดปัญหาในการติดต่อเซิร์ฟเวอร์ของ Google
INVALID_REQUEST	GeocoderRequest นี้ไม่ถูกต้อง
OK	การตอบกลับมี GeocoderResponse ที่ถูกต้อง
OVER_QUERY_LIMIT	หน้าเว็บเกินขีดจํากัดที่ขอในระยะเวลาสั้นๆ
REQUEST_DENIED	หน้าเว็บไม่ได้รับอนุญาตให้ใช้ไวลด์การ์ด
UNKNOWN_ERROR	ไม่สามารถประมวลผลคําขอการเข้ารหัสภูมิศาสตร์ได้เนื่องจากเกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คําขออาจประสบความสําเร็จหากลองอีกครั้ง
ZERO_RESULTS	ไม่พบผลการค้นหาสําหรับ GeocoderRequest นี้

อินเทอร์เฟซ GeocoderResponse

อินเทอร์เฟซ google.maps.GeocoderResponse

การตอบกลับ Geocoder แสดงผลโดย Geocoder ที่มีรายการ GeocoderResult

พร็อพเพอร์ตี้
results	ประเภท:  Array<GeocoderResult> รายชื่อ GeocoderResult วินาที

อินเทอร์เฟซ GeocoderResult

อินเทอร์เฟซ google.maps.GeocoderResult

ผลลัพธ์หนึ่งของรหัสพิกัดเซิร์ฟเวอร์ที่เรียกมาจากเซิร์ฟเวอร์รหัสพิกัด คําขอรหัสพิกัดภูมิศาสตร์อาจแสดงออบเจ็กต์ผลลัพธ์หลายรายการ โปรดทราบว่าแม้ว่าผลลัพธ์นี้จะ "เหมือน JSON" แต่ก็ไม่ใช่ JSON เลย เนื่องจากประกอบด้วยออบเจ็กต์ LatLng ทางอ้อม

พร็อพเพอร์ตี้
address_components	ประเภท:  Array<GeocoderAddressComponent> อาร์เรย์ของ GeocoderAddressComponent วินาที
formatted_address	ประเภท:  string สตริงที่มีที่อยู่ที่มนุษย์อ่านได้ของสถานที่นี้
geometry	ประเภท:  GeocoderGeometry ออบเจ็กต์ GeocoderGeometry
place_id	ประเภท:  string รหัสสถานที่ที่เชื่อมโยงกับสถานที่ตั้ง รหัสสถานที่จะระบุสถานที่ในฐานข้อมูลของ Google Places และใน Google Maps โดยไม่ซ้ํา ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ในคู่มือนักพัฒนาซอฟต์แวร์ Places API
types	ประเภท:  Array<string> อาร์เรย์ของสตริงที่แสดงถึงประเภทขององค์ประกอบที่ระบุทางภูมิศาสตร์ซึ่งแสดงผลกลับมา ดูรายการสตริงที่เป็นไปได้ที่หัวข้อ ประเภทคอมโพเนนต์ที่อยู่ของคู่มือสําหรับนักพัฒนาซอฟต์แวร์
partial_match optional	ประเภท:  boolean optional ตัวระบุโดเมนไม่ได้แสดงผลคําขอที่แน่ชัดสําหรับคําขอเดิมหรือไม่ แม้ว่าจะจับคู่กับที่อยู่ที่ส่งคําขอไว้ได้หรือไม่ หากค่าที่ตรงกันทุกประการ ค่าจะเป็น undefined
plus_code optional	ประเภท:  PlacePlusCode optional Plus Code ที่เชื่อมโยงกับสถานที่ตั้ง
postcode_localities optional	ประเภท:  Array<string> optional อาร์เรย์ของสตริงที่แสดงถึงย่านใกล้เคียงทั้งหมดในรหัสไปรษณีย์ ตัวเลือกนี้จะปรากฏเมื่อผลลัพธ์เป็นรหัสไปรษณีย์ที่มีหลายท้องถิ่นเท่านั้น

อินเทอร์เฟซ GeocoderAddressElement

อินเทอร์เฟซ google.maps.GeocoderAddressComponent

คอมโพเนนต์ที่อยู่เดียวภายใน GeocoderResult ที่อยู่แบบเต็มอาจประกอบด้วยองค์ประกอบที่อยู่หลายรายการ

พร็อพเพอร์ตี้
long_name	ประเภท:  string ข้อความทั้งหมดของคอมโพเนนต์ที่อยู่
short_name	ประเภท:  string ตัวย่อสั้นๆ ของคอมโพเนนต์ที่อยู่หนึ่งๆ
types	ประเภท:  Array<string> อาร์เรย์ของสตริงที่แสดงถึงประเภทของคอมโพเนนต์ที่อยู่นี้ ดูรายการประเภทที่ถูกต้องได้ที่นี่

อินเทอร์เฟซ GeocoderGeometry

อินเทอร์เฟซ google.maps.GeocoderGeometry

ข้อมูลเรขาคณิตเกี่ยวกับGeocoderResultนี้

พร็อพเพอร์ตี้
location	ประเภท:  LatLng พิกัดละติจูดและลองจิจูดของผลการค้นหานี้
location_type	ประเภท:  GeocoderLocationType ประเภทของสถานที่ที่กลับมาใน location
viewport	ประเภท:  LatLngBounds ขอบเขตของวิวพอร์ตที่แนะนําเพื่อแสดง GeocoderResult นี้
bounds optional	ประเภท:  LatLngBounds optional ขอบเขตที่แน่นอนของ GeocoderResult นี้ (หากมี)

GeocoderLocationType ค่าคงที่

google.maps.GeocoderLocationType ค่าคงที่

อธิบายประเภทสถานที่ตั้งที่ส่งกลับจากพิกัด ระบุค่าตามค่าเหล่านี้ หรือใช้ชื่อค่าคงที่ เช่น 'ROOFTOP' หรือ google.maps.GeocoderLocationType.ROOFTOP

เข้าถึงได้โดยโทรหา const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") โปรดดูไลบรารีใน Maps JavaScript API

ค่าคงที่
APPROXIMATE	ผลลัพธ์ที่ได้กลับมาเป็นค่าโดยประมาณ
GEOMETRIC_CENTER	ผลลัพธ์ที่แสดงคือศูนย์กลางทางเรขาคณิตของผลลัพธ์นั้น เช่น เส้น (เช่น ถนน) หรือรูปหลายเหลี่ยม (ภูมิภาค)
RANGE_INTERPOLATED	ส่วนผลการค้นหาที่แสดงจะแสดงค่าประมาณ (เช่น บนถนน) โดยประมาณระหว่างจุด 2 จุดที่แน่นอน (เช่น สี่แยก) โดยทั่วไปแล้ว ผลการค้นหาที่มีการรบกวนจะแสดงเมื่อพิกัดทางภูมิศาสตร์ไม่พร้อมใช้งานสําหรับที่อยู่
ROOFTOP	ส่วนผลลัพธ์ที่แสดงผลจะมีพิกัดทางภูมิศาสตร์ที่ถูกต้อง