Geocoder

Geocoder class

google.maps.Geocoder ชั้นเรียน

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

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

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

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

ข้อกำหนดสำหรับคำขอ Geocoding ที่จะส่งไปยัง Geocoder

พร็อพเพอร์ตี้
address optional	ประเภท:  string optional ที่อยู่ที่ต้องการเข้ารหัสพิกัดภูมิศาสตร์ ต้องระบุ address, location และ placeId อย่างใดอย่างหนึ่งเท่านั้น
bounds optional	ประเภท:  LatLngBounds|LatLngBoundsLiteral optional LatLngBounds ที่จะค้นหา ไม่บังคับ
componentRestrictions optional	ประเภท:  GeocoderComponentRestrictions optional โดยใช้คอมโพเนนต์เพื่อจำกัดผลลัพธ์ให้อยู่ในพื้นที่ที่เฉพาะเจาะจง ตัวกรองประกอบด้วยรายการต่อไปนี้อย่างน้อย 1 รายการ route, locality, administrativeArea, postalCode, country ระบบจะแสดงเฉพาะผลการค้นหาที่ตรงกับตัวกรองทั้งหมด ค่าตัวกรองรองรับวิธีการแก้ไขการสะกดและการจับคู่บางส่วนแบบเดียวกับคำขอ Geocoding อื่นๆ ไม่บังคับ
extraComputations optional	ประเภท:  Array<ExtraGeocodeComputation> optional รายการการคำนวณเพิ่มเติมที่อาจใช้เพื่อดำเนินการตามคำขอ หมายเหตุ: การคำนวณเพิ่มเติมเหล่านี้อาจแสดงช่องเพิ่มเติมในการตอบกลับ
fulfillOnZeroResults optional	ประเภท:  boolean optional ทำตามสัญญาในสถานะ ZERO_RESULT ในการตอบกลับ ซึ่งอาจเป็นสิ่งที่ต้องการเนื่องจากแม้จะไม่มีผลการแปลงรหัสพิกัดภูมิศาสตร์ แต่ก็อาจยังมีช่องระดับการตอบกลับเพิ่มเติมที่แสดง
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 2 อักขระ (ไม่ใช่ตัวเลข) / ตัวระบุ CLDR ไม่บังคับ ดูภูมิภาคที่รองรับได้ที่รายละเอียดความครอบคลุมของ Google Maps Platform

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

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

GeocoderComponentRestrictions แสดงชุดตัวกรองที่ระบุพื้นที่ที่เฉพาะเจาะจง โปรดดูรายละเอียดเกี่ยวกับวิธีการทำงานนี้ที่ การกรองคอมโพเนนต์ Geocoding

ExtraGeocodeComputation ค่าคงที่

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

การคำนวณเพิ่มเติมที่จะดำเนินการขณะประมวลผลคำขอ Geocoding

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

GeocoderStatus ค่าคงที่

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

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

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

GeocoderResponse interface

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

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

พร็อพเพอร์ตี้
results	ประเภท:  Array<GeocoderResult> รายการ GeocoderResult
address_descriptor optional	ประเภท:  AddressDescriptor optional คำอธิบายเชิงสัมพันธ์ของสถานที่ ประกอบด้วยชุดจุดสังเกตที่อยู่ใกล้เคียงซึ่งจัดอันดับไว้และพื้นที่ที่มีสถานที่เป้าหมาย โดยจะระบุข้อมูลสำหรับคำขอ Geocoding แบบย้อนกลับเท่านั้น และจะระบุเมื่อเปิดใช้ ExtraGeocodeComputation.ADDRESS_DESCRIPTORS เท่านั้น
plus_code optional	ประเภท:  PlacePlusCode optional Plus Code ที่เชื่อมโยงกับสถานที่

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

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

ผลลัพธ์ Geocoder รายการเดียวที่ดึงมาจากเซิร์ฟเวอร์ Geocode คำขอ Geocode อาจแสดงออบเจ็กต์ผลลัพธ์หลายรายการ โปรดทราบว่าแม้ผลลัพธ์นี้จะ "คล้าย 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> อาร์เรย์ของสตริงที่ระบุประเภทขององค์ประกอบที่แปลงเป็นพิกัดภูมิศาสตร์ที่แสดงผล ดูรายการสตริงที่เป็นไปได้ได้ที่ส่วน ประเภทคอมโพเนนต์ของที่อยู่ในคู่มือสำหรับนักพัฒนาซอฟต์แวร์
address_descriptor optional	ประเภท:  AddressDescriptor optional คำอธิบายเชิงสัมพันธ์ของสถานที่ที่เชื่อมโยงกับรหัสพิกัดภูมิศาสตร์นี้ ประกอบด้วยชุดจุดสังเกตที่อยู่ใกล้เคียงซึ่งจัดอันดับไว้และพื้นที่ที่มีสถานที่เป้าหมาย ระบบจะป้อนข้อมูลนี้สำหรับคำขอการแปลงพิกัดเป็นชื่อและคำขอการค้นหารหัสสถานที่เท่านั้น เมื่อเปิดใช้ ExtraGeocodeComputation.ADDRESS_DESCRIPTORS และสำหรับสถานที่ที่แปลแล้วบางแห่งเท่านั้น
partial_match optional	ประเภท:  boolean optional ไม่ว่า Geocoder จะไม่แสดงผลการจับคู่ที่ตรงกันทุกประการสำหรับคำขอเดิม แม้ว่าจะจับคู่ส่วนหนึ่งของที่อยู่ที่ขอได้ก็ตาม หากตรงกันทุกประการ ค่าจะเป็น undefined
plus_code optional	ประเภท:  PlacePlusCode optional Plus Code ที่เชื่อมโยงกับสถานที่
postcode_localities optional	ประเภท:  Array<string> optional อาร์เรย์ของสตริงที่ระบุสถานที่ทั้งหมดที่อยู่ในรหัสไปรษณีย์ ซึ่งจะปรากฏเฉพาะเมื่อผลการค้นหาเป็นรหัสไปรษณีย์ที่มีหลายพื้นที่

AddressDescriptor interface

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

คำอธิบายเชิงสัมพันธ์ของสถานที่ ประกอบด้วยชุดจุดสังเกตที่อยู่ใกล้เคียงซึ่งจัดอันดับไว้และพื้นที่ที่มีสถานที่เป้าหมาย