Geocoder

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

Geocoder คลาส

google.maps.Geocoder คลาส

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

Geocoder
Geocoder()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ Geocoder ที่ส่งคําขอไวลด์การ์ดไปยังเซิร์ฟเวอร์ของ Google
geocode
geocode(request[, callback])
พารามิเตอร์:
แสดงผลค่า: 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 โดยจะแสดงเฉพาะผลลัพธ์ที่ตรงกับตัวกรองทั้งหมดเท่านั้น ค่าตัวกรองรองรับวิธีการแก้ไขตัวสะกดและการจับคู่บางส่วนเช่นเดียวกับคําขอการเขียนโค้ดตามภูมิศาสตร์อื่นๆ ไม่บังคับ
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

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

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