Geocoder

Geocoder class

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

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

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

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 อื่นๆ ไม่บังคับ
BetaextraComputations 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
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 ไม่บังคับ

ExtraGeocodeComputation ค่าคงที่

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

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

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

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 หน้าเว็บไม่ได้รับอนุญาตให้ใช้ Geocoder
UNKNOWN_ERROR ประมวลผลคำขอ Geocoding ไม่ได้เนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ คำขออาจสำเร็จหากคุณลองอีกครั้ง
ZERO_RESULTS ไม่พบผลลัพธ์สำหรับ GeocoderRequest นี้

GeocoderResponse interface

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

การตอบกลับของ Geocoder ที่ Geocoder แสดงผลซึ่งมีรายการ GeocoderResult
results
ประเภท:  Array<GeocoderResult>
รายการ GeocoderResult
Betaaddress_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>
อาร์เรย์ของสตริงที่ระบุประเภทขององค์ประกอบที่แปลงเป็นพิกัดภูมิศาสตร์ที่แสดงผล ดูรายการสตริงที่เป็นไปได้ได้ที่ส่วน ประเภทคอมโพเนนต์ของที่อยู่ในคู่มือสำหรับนักพัฒนาซอฟต์แวร์
Betaaddress_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 อินเทอร์เฟซ

คำอธิบายเชิงสัมพันธ์ของสถานที่ ประกอบด้วยชุดจุดสังเกตที่อยู่ใกล้เคียงซึ่งจัดอันดับไว้และพื้นที่ที่มีสถานที่เป้าหมาย
areas
ประเภท:  Array<Area>
รายการพื้นที่ที่อยู่หรือติดกันที่จัดอันดับแล้ว ระบบจะจัดอันดับพื้นที่ที่มีประโยชน์มากที่สุด (จดจำได้และแม่นยำ) เป็นอันดับแรก
landmarks
ประเภท:  Array<Landmark>
รายการจุดสังเกตที่อยู่ใกล้เคียงที่จัดอันดับแล้ว จุดสังเกตที่มีประโยชน์มากที่สุด (จดจำได้และอยู่ใกล้เคียง) จะได้รับการจัดอันดับเป็นอันดับแรก

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

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 ผลลัพธ์ที่แสดงจะแสดงรหัสพิกัดภูมิศาสตร์ที่แม่นยำ

อินเทอร์เฟซจุดสังเกต

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

สถานที่ที่แสดงจุดอ้างอิงสำหรับที่อยู่
display_name
ประเภท:  string
ชื่อของสถานที่สำคัญ
display_name_language_code
ประเภท:  string
ภาษาของชื่อสถานที่สำคัญ
place_id
ประเภท:  string
รหัสสถานที่ของสถานประกอบการพื้นฐานที่ใช้เป็นสถานที่สำคัญ ใช้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับสถานที่สำคัญผ่านรายละเอียดสถานที่หรือการค้นหา Place ID ได้
spatial_relationship
ประเภท:  SpatialRelationship
กำหนดความสัมพันธ์เชิงพื้นที่ระหว่างตำแหน่งเป้าหมายกับสถานที่สำคัญ
straight_line_distance_meters
ประเภท:  number
ระยะทางเป็นเส้นตรงระหว่างสถานที่เป้าหมายกับสถานที่สำคัญ
types
ประเภท:  Array<string>
ค่าอย่างน้อย 1 ค่าที่ระบุประเภทของผลลัพธ์ที่แสดง โปรดดูรายละเอียดเพิ่มเติมในประเภท
travel_distance_meters optional
ประเภท:  number optional
ระยะทางการเดินทางตามเครือข่ายถนนระหว่างสถานที่เป้าหมายกับสถานที่สำคัญ คุณสามารถปล่อยให้ฟิลด์นี้ว่างไว้ได้หากสถานที่สำคัญไม่ได้เชื่อมต่อกับส่วนของเครือข่ายถนนที่เป้าหมายอยู่ใกล้ที่สุด หรือหากระบบไม่ได้พิจารณาว่าตำแหน่งเป้าหมายอยู่บนเครือข่ายถนน

พื้นที่ อินเทอร์เฟซ

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

สถานที่ที่เป็นภูมิภาคขนาดเล็ก เช่น ย่านใกล้เคียง เขตย่อย หรือคอมเพล็กซ์ขนาดใหญ่ที่มีสถานที่เป้าหมาย
containment
ประเภท:  Containment
กำหนดความสัมพันธ์เชิงพื้นที่ระหว่างตำแหน่งเป้าหมายกับพื้นที่
display_name
ประเภท:  string
ชื่อของพื้นที่
display_name_language_code
ประเภท:  string
ภาษาของชื่อสำหรับพื้นที่
place_id
ประเภท:  string
รหัสสถานที่ของพื้นที่พื้นฐาน ใช้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับพื้นที่ผ่านรายละเอียดสถานที่หรือการค้นหารหัสสถานที่ได้

Containment ค่าคงที่

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

การแจงนับที่แสดงความสัมพันธ์เชิงพื้นที่ระหว่างพื้นที่กับสถานที่ตั้งเป้าหมาย

เข้าถึงได้โดยโทรไปที่ const {Containment} = await google.maps.importLibrary("geocoding")
ดูไลบรารีใน Maps JavaScript API
NEAR สถานที่เป้าหมายอยู่นอกภูมิภาค แต่ใกล้เคียง
OUTSKIRTS ตำแหน่งเป้าหมายอยู่ภายในภูมิภาคของพื้นที่ ใกล้กับขอบ
WITHIN ตำแหน่งเป้าหมายอยู่ภายในภูมิภาคพื้นที่ ใกล้กับศูนย์กลาง

SpatialRelationship ค่าคงที่

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

การแจงนับที่แสดงความสัมพันธ์ในพื้นที่ระหว่างจุดสังเกตกับเป้าหมาย

เข้าถึงได้โดยโทรไปที่ const {SpatialRelationship} = await google.maps.importLibrary("geocoding")
ดูไลบรารีใน Maps JavaScript API
ACROSS_THE_ROAD เป้าหมายอยู่ตรงข้ามกับสถานที่สำคัญบนอีกฝั่งของถนน
AROUND_THE_CORNER ไม่ได้อยู่บนเส้นทางเดียวกับสถานที่สำคัญ แต่เลี้ยวเพียงครั้งเดียวก็ถึง
BEHIND ใกล้กับโครงสร้างของสถานที่สำคัญ แต่ไกลจากจุดเข้าถึง
BESIDE เป้าหมายอยู่ติดกับสถานที่สำคัญโดยตรง
DOWN_THE_ROAD ในเส้นทางเดียวกับสถานที่สำคัญ แต่ไม่อยู่ข้างหรือตรงข้าม
NEAR นี่คือความสัมพันธ์เริ่มต้นเมื่อไม่มีความสัมพันธ์ที่เฉพาะเจาะจงกว่านี้ด้านล่าง
WITHIN สถานที่สำคัญมีเรขาคณิตเชิงพื้นที่และเป้าหมายอยู่ภายในขอบเขต