Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Cara geocode menggunakan konteks geospasial
<a name="how-to-geocode-geospatial"></a>

Geocode API memungkinkan Anda untuk menggunakan konteks geospasial (seperti posisi bias) untuk mendapatkan hasil yang diinginkan.

**catatan**  
“Posisi bias” mengacu pada mekanisme yang memprioritaskan hasil pencarian berdasarkan lokasi yang ditentukan pengguna atau area yang ditentukan. Ini pada dasarnya menggeser fokus hasil pencarian ke lokasi yang secara geografis lebih dekat ke titik bias yang ditunjuk, tanpa harus mengecualikan hasil lainnya. 

## Potensi penggunaan
<a name="geospatial-uses"></a>

Gunakan konteks geospasial untuk mendapatkan hasil yang benar berdasarkan kebutuhan bisnis Anda.

## Contoh
<a name="geospatial-examples"></a>

### Bias menghasilkan suatu posisi
<a name="bias-position-example"></a>

Dengan bias ke posisi, Anda dapat mengubah peringkat hasil Anda. Coba contoh berikut, dengan—dan kemudian `BiasPosition` tanpa—nilainya dan bandingkan hasilnya.

------
#### [ Sample request ]

```
{
    "QueryText": "George Street",
    "BiasPosition": [
                151.2059,
                -33.8691
            ]
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Street",
            "Title": "George St, Sydney NSW, Australia",
            "Address": {
                "Label": "George St, Sydney NSW, Australia",
                "Country": {
                    "Code2": "AU",
                    "Code3": "AUS",
                    "Name": "Australia"
                },
                "Region": {
                    "Code": "NSW",
                    "Name": "New South Wales"
                },
                "Locality": "Sydney",
                "Street": "George St",
                "StreetComponents": [
                    {
                        "BaseName": "George",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ]
            },
            "Position": [
                151.20691,
                -33.86974
            ],
            "Distance": 117,
            "MapView": [
                151.20225,
                -33.88406,
                151.20912,
                -33.85635
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Intersection": [
                            1
                        ]
                    }
                }
            }
        },
        ...
        ...
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "George Street",
    "BiasPosition": [
                151.2059,
                -33.8691
            ]
}'
```

------
#### [ AWS CLI ]

```
aws geo-places geocode --key ${YourKey} --query-text "George Street" --bias-position 151.2059 -33.8691
```

------

## Kiat pengembang
<a name="geospatial-developer-tips"></a>

Untuk geocoding alamat, coba gunakan alamat lengkap atau komponen kueri dengan kombinasi posisi bias, termasuk negara dan tempat. Untuk mempelajari informasi lebih lanjut, lihat [Cara membuat geokode alamat](how-to-geocode-address.md).