Geocoder

คลาส Geocoder

google.maps.Geocoder คลาส
ไลบรารี "geocoding"

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

const {Geocoder} = await google.maps.importLibrary("geocoding");

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

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

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

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

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

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

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

ค่าคงที่ ExtraGeocodeComputation

google.maps.ExtraGeocodeComputation ค่าคงที่
ไลบรารี "geocoding"

การคำนวณเพิ่มเติมที่ต้องทำขณะดำเนินการตามคำขอการเข้ารหัสพิกัดภูมิศาสตร์

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท ExtraGeocodeComputationString

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");

ค่าคงที่ GeocoderStatus

google.maps.GeocoderStatus ค่าคงที่
ไลบรารี "geocoding"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท GeocoderStatusString

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");

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

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

การตอบกลับของโปรแกรมเข้ารหัสพิกัดภูมิศาสตร์ที่แสดงผลโดย Geocoder ซึ่งมีรายการ GeocoderResult

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

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

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

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

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

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

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

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

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

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

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

ค่าคงที่ GeocoderLocationType

google.maps.GeocoderLocationType ค่าคงที่
ไลบรารี "geocoding"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท GeocoderLocationTypeString

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");

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

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

สถานที่ที่แสดงจุดอ้างอิงสำหรับที่อยู่

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

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

สถานที่ที่เป็นภูมิภาคขนาดเล็ก เช่น ย่าน สถานที่ย่อย หรืออาคารขนาดใหญ่ที่มีสถานที่เป้าหมายอยู่

ค่าคงที่การล้อมองค์ประกอบ

google.maps.Containment ค่าคงที่
ไลบรารี "geocoding"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท ContainmentString

const {Containment} = await google.maps.importLibrary("geocoding");

ค่าคงที่ SpatialRelationship

google.maps.SpatialRelationship ค่าคงที่
ไลบรารี "geocoding"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท SpatialRelationshipString

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");