Prasyarat

Sebelum Anda memulai geocoding, membalikkan geocoding atau mencari tempat, ikuti langkah-langkah prasyarat:

Membuat sumber daya indeks tempat

Mulailah dengan membuat sumber daya indeks tempat di AWS akun Anda.

Saat membuat sumber daya indeks tempat, Anda dapat memilih dari penyedia data yang tersedia untuk mendukung kueri geocoding, geocoding terbalik, dan penelusuran:

1. Esri — Untuk informasi lebih lanjut tentang cakupan Esri di wilayah minat Anda, lihat cakupan geocoding Esri dalam dokumentasi Esri.

2. HERE Technologies - Untuk informasi lebih lanjut tentang cakupan HERE di wilayah yang Anda minati, lihat cakupan geocoding HERE dalam dokumentasi HERE.

3. Grab — Grab menyediakan data hanya untuk Asia Tenggara. Untuk informasi selengkapnya tentang cakupan Grab, lihat Negara/wilayah dan area yang dicakup di panduan ini.

Anda dapat melakukannya menggunakan konsol Amazon Location Service, the AWS CLI, atau Amazon Location API.

Console

Untuk membuat sumber daya indeks tempat menggunakan konsol Amazon Location Service

1. Buka konsol Amazon Location Service di https://console.aws.amazon.com/location/.

2. Di panel navigasi kiri, pilih Tempatkan indeks.

3. Pilih Buat indeks tempat.

4. Isi kotak-kotak berikut:

   • Nama — Masukkan nama untuk sumber daya indeks tempat. Misalnya, ExamplePlaceIndex. Maksimal 100 karakter. Entri yang valid termasuk karakter alfanumerik, tanda hubung, titik, dan garis bawah.

   • Deskripsi - Masukkan deskripsi opsional.

5. Di bawah Penyedia data, pilih penyedia data yang tersedia untuk digunakan dengan sumber daya indeks tempat Anda.

   catatan

   Jika aplikasi Anda melacak atau merutekan aset yang Anda gunakan dalam bisnis Anda, seperti kendaraan pengiriman atau karyawan, Anda tidak boleh menggunakan Esri sebagai penyedia geolokasi Anda. Lihat bagian 82 dari ketentuanAWS layanan untuk detail selengkapnya.

6. Di bawah Opsi penyimpanan data, tentukan apakah Anda ingin menyimpan hasil penelusuran dari sumber daya indeks tempat Anda.

7. (Opsional) Di bawah Tag, masukkan tag Kunci dan Nilai. Ini menambahkan tag sumber daya indeks tempat baru Anda. Untuk informasi selengkapnya, lihat Menandai sumber daya Anda.

8. Pilih Buat indeks tempat.

API

Untuk membuat sumber daya indeks tempat menggunakan Amazon Location API

Gunakan CreatePlaceIndex operasi dari Amazon Location Places API.

Contoh berikut adalah permintaan API untuk membuat sumber daya indeks tempat yang disebut ExamplePlaceIndexmenggunakan penyedia data Esri.

POST /places/v0/indexes
Content-type: application/json

{
   "DataSource": "Esri",
   "DataSourceConfiguration": { 
      "IntendedUse": "SingleUse"
   },
   "Description": "string",
   "IndexName": "ExamplePlaceIndex",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}

AWS CLI

Untuk membuat sumber daya indeks tempat menggunakan AWS CLI perintah

Gunakan perintah create-place-index.

Contoh berikut menciptakan sumber daya indeks tempat yang disebut ExamplePlaceIndexmenggunakan Esri sebagai penyedia data.

aws location \
  create-place-index \
  --data-source "Esri" \
  --description "Example place index" \
  --index-name "ExamplePlaceIndex" \
  --tags Tag1=Value1

catatan

Penagihan tergantung pada penggunaan Anda. Anda mungkin dikenakan biaya untuk penggunaan AWS layanan lain. Untuk informasi selengkapnya, lihat harga Amazon Location Service.

Mengautentikasi permintaan Anda

Setelah Anda membuat sumber daya indeks tempat dan Anda siap untuk mulai membangun fitur lokasi ke dalam aplikasi Anda, pilih bagaimana Anda akan mengautentikasi permintaan Anda:

• Untuk mempelajari cara mengakses layanan, lihat Mengakses Amazon Location Service.

• Jika Anda memiliki situs web dengan pengguna anonim, Anda mungkin ingin menggunakan Kunci API atau Amazon Cognito.

  Contoh

  Contoh berikut menunjukkan penggunaan kunci API untuk otorisasi, menggunakan AWS JavaScript SDK v3, dan Lokasi Amazon. JavaScript Pembantu otentikasi

  import { LocationClient, SearchPlaceIndexForTextCommand } from "@aws-sdk/client-location";
  import { withAPIKey } from "@aws/amazon-location-utilities-auth-helper";
  
  const apiKey = "v1.public.your-api-key-value"; // API key
  
  // Create an authentication helper instance using an API key
  const authHelper = await withAPIKey(apiKey);
  
  const client = new LocationClient({
    region: "<region>", // region containing Cognito pool
    ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location
  });
  
  const input = {
    IndexName: "ExamplePlaceIndex",
    Text: "Anyplace",
    BiasPosition: [-123.4567, 45.6789]
  };
  
  const command = new SearchPlaceIndexForTextCommand(input);
  
  const response = await client.send(command);