Geocoder

Geocoder class

google.maps.Geocoder class

บริการสำหรับแปลงที่อยู่เป็น LatLng หรือแปลง LatLng เป็นที่อยู่

เข้าถึงโดยการโทรหา const {Geocoder} = await google.maps.importLibrary("geocoding") โปรดดูไลบรารีใน Maps JavaScript API
Geocoder
Geocoder()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ Geocoder ที่ส่งคำขอพิกัดทางภูมิศาสตร์ไปยังเซิร์ฟเวอร์ของ Google
geocode
geocode(request[, callback])
พารามิเตอร์: 
ผลลัพธ์:  Promise<GeocoderResponse>
จับคู่คำขอกับรหัสพิกัดภูมิศาสตร์

GeocoderRequest interface

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

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

GeocoderComponentRestrictions interface

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

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

GeocoderStatus constants

google.maps.GeocoderStatus constants

สถานะที่ 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 แสดงรายการ 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
อาร์เรย์สตริงที่แสดงถึงสถานที่ทั้งหมดที่อยู่ในรหัสไปรษณีย์ ตัวเลือกนี้จะปรากฏขึ้นเมื่อผลลัพธ์เป็นรหัสไปรษณีย์ที่มีสถานที่ตั้งหลายแห่งเท่านั้น

GeocoderAddressComponent interface

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 constants

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

เข้าถึงโดยการโทรหา const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") โปรดดูไลบรารีใน Maps JavaScript API
APPROXIMATE ผลลัพธ์ที่แสดงเป็นค่าโดยประมาณ
GEOMETRIC_CENTER ผลลัพธ์ที่แสดงคือจุดศูนย์กลางเชิงเรขาคณิตของผลลัพธ์ เช่น เส้น (เช่น ถนน) หรือรูปหลายเหลี่ยม (ภูมิภาค)
RANGE_INTERPOLATED ผลลัพธ์ที่แสดงจะแสดงค่าโดยประมาณ (มักจะอยู่บนถนน) ที่หาค่าระหว่างจุดที่แน่นอน 2 จุด (เช่น แยก) โดยทั่วไปแล้ว ระบบจะแสดงผลลัพธ์ที่ประมาณเมื่อไม่มีรหัสพิกัดบนหลังคาสำหรับที่อยู่
ROOFTOP ผลลัพธ์ที่แสดงจะแสดงพิกัดภูมิศาสตร์ที่แม่นยำ