Metode Geocoding API v4 memiliki kuota default 25 kueri per detik (QPS). Untuk mengetahui informasi tentang cara meminta kuota yang lebih tinggi, lihat Melihat dan mengelola kuota, lalu pilih Geocoding API sebagai layanan.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Menelusuri tujuan

Developer Wilayah Ekonomi Eropa (EEA)

A Destination mengacu pada lokasi atau tempat tertentu yang ingin dicapai atau dituju oleh pengguna. Destination juga mencakup kumpulan informasi terkait lokasi atau tempat, seperti titik navigasi, landmark, pintu masuk, dan garis luar bangunan.

Metode SearchDestinations Geocoding API memungkinkan Anda mengambil informasi mendetail tentang berbagai tujuan berdasarkan kriteria input yang berbeda, seperti alamat, ID tempat, atau koordinat lintang dan bujur.

Permintaan penelusuran tujuan

Permintaan penelusuran tujuan request adalah permintaan POST HTTP ke URL dalam bentuk:

https://geocode.googleapis.com/v4/geocode/destinations

Teruskan semua parameter dalam isi permintaan JSON atau di header sebagai bagian dari permintaan POST. Contoh:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Anda dapat menentukan lokasi untuk menelusuri tujuan dengan salah satu dari 3 cara:

Alamat
ID tempat
Koordinat lintang dan bujur

Menelusuri tujuan berdasarkan alamat

Anda dapat menentukan alamat sebagai string yang tidak terstruktur. Geocoding alamat tidak menyelesaikan koordinat lintang dan bujur, atau string tidak terstruktur lainnya yang tidak mewakili alamat. Permintaan yang menggunakan string tersebut tidak didukung dan dapat menyebabkan respons error atau perilaku yang tidak ditentukan. Contoh kueri yang tidak didukung mencakup hal berikut:

Jenis kueri	Contoh
Koordinat lintang dan bujur. Sebagai gantinya, gunakan kueri lokasi.	"37.422131,-122.084801"
Terlalu banyak konsep atau batasan, seperti nama beberapa tempat, jalan, atau kota dalam satu kueri	"Market Street San Francisco San Jose Airport"
Elemen alamat pos yang tidak ditampilkan di Google Maps	"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco"
Nama bisnis, jaringan, atau kategori yang digabungkan dengan lokasi tempat entitas ini tidak tersedia	"Tesco near Dallas, Texas"
Kueri ambigu dengan beberapa interpretasi	"Charger drop-off"
Nama historis yang tidak lagi digunakan	"Middlesex United Kingdom"
Elemen atau intent non-geospasial	"How many boats are in Ventura Harbor?"
Nama tidak resmi atau nama vanity	"The Jenga" "The Helter Skelter"
Entitas politik besar (Kota, Negara Bagian, Negara)	"New York City" "California" "USA"
Rute tanpa alamat tertentu	"1st Ave., NYC, NY" "I-95"

curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

atau sebagai postalAddress:

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Biasanya, Anda menggunakan format postalAddress saat memproses komponen alamat yang diambil dalam formulir HTML.

Menelusuri tujuan berdasarkan ID tempat

Anda dapat mengambil tujuan dengan memberikan ID tempat:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

ID Tempat yang Didukung

Metode Search Destinations berfungsi paling baik dengan ID Tempat yang mewakili tujuan tertentu yang dapat dinavigasi. ID Tempat untuk jenis seperti establishment, point_of_interest, premise, street_address, dan subpremise umumnya didukung. ID Tempat yang tidak mewakili lokasi terpisah, seperti yang disimpulkan dari rentang alamat (misalnya, "10-20 Main St"), bagian rute tanpa nomor tertentu, atau kode plus tidak didukung. ID Tempat untuk hasil yang terlalu luas (misalnya, "Samudra Pasifik") juga tidak didukung.

Menggunakan Place Autocomplete (Baru) Places API dengan Search Destinations

Untuk memastikan kompatibilitas, gunakan Place Autocomplete (Baru) Places API untuk menemukan ID Tempat yang akan digunakan dengan Search Destinations. Saat menggunakan Autocomplete, Anda harus memfilter hasil menurut jenis menggunakan includedPrimaryTypes parameter. ID Tempat yang ditampilkan oleh Autocomplete menggunakan filter yang direkomendasikan berikut didukung oleh Search Destinations:

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

Selain itu, Anda tidak boleh menetapkan include_pure_service_area_businesses flag ke true dalam permintaan Autocomplete.

Menelusuri tujuan berdasarkan lokasi

Anda dapat menelusuri tujuan dengan memberikan koordinat lintang dan bujur:

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Menggunakan OAuth untuk membuat permintaan

Geocoding API v4 mendukung OAuth 2.0 untuk autentikasi. Untuk menggunakan OAuth dengan Geocoding API, token OAuth harus diberi cakupan yang benar. Geocoding API mendukung cakupan berikut untuk digunakan dengan metode Destinations:

https://www.googleapis.com/auth/maps-platform.geocode — Gunakan dengan semua metode Geocoding API.

Selain itu, Anda dapat menggunakan cakupan https://www.googleapis.com/auth/cloud-platform umum untuk semua metode Geocoding API. Cakupan tersebut berguna selama pengembangan, tetapi tidak untuk produksi, karena cakupan tersebut adalah cakupan umum yang memungkinkan akses ke semua metode.

Untuk mengetahui informasi dan contoh selengkapnya, lihat Menggunakan OAuth.

Respons penelusuran tujuan

Respons Search Destinations memberikan konteks hyperlocal yang kaya tentang lokasi.

Objek PlaceView dalam respons Search Destinations (seperti primary, item di containingPlaces, dan landmarks) menggunakan kolom untuk menunjukkan jenis tempat:

types: Array string yang menunjukkan jenis tempat.
primaryType: String yang menunjukkan jenis utama tempat.

Nilai string yang mungkin untuk types dan primaryType diambil dari Tabel A dan Tabel B di halaman Jenis Tempat (Baru).

Bagian ini menjelaskan kolom respons utama. Untuk mengetahui detail selengkapnya tentang semua kolom respons, lihat Referensi API.

`primary`

Tempat utama yang diidentifikasi oleh kueri dalam permintaan.

`containingPlaces`

Entitas yang lebih besar yang menjadi bagian dari tujuan utama (misalnya, mal yang berisi toko).

`subDestinations`

Lokasi yang lebih spesifik dalam tujuan utama (misalnya, apartemen di gedung).

`entrances`

Objek dalam array entrances[] memiliki kolom berikut:

location

Satu pasangan koordinat lintang/bujur yang menentukan lokasi titik masuk dan keluar ke suatu tempat.
entrance_tags[]

Array tag pintu masuk yang menjelaskan karakteristik pintu masuk. Nilai berikut didukung:
- "PREFERRED"
Menunjukkan bahwa pintu masuk ini kemungkinan menyediakan akses fisik ke tempat yang ditampilkan. Suatu tempat dapat memiliki beberapa pintu masuk pilihan. Jika pintu masuk tidak memiliki tag ini, berarti pintu masuk tersebut secara fisik berada di gedung yang sama , tetapi tidak selalu memberikan akses ke tempat tersebut.

Misalnya, jika tempat yang ditampilkan adalah restoran di mal strip, pintu masuk "PREFERRED" akan menjadi pintu masuk yang mengarah ke restoran itu sendiri, sedangkan pintu masuk lain yang ditampilkan akan menjadi pintu masuk lain untuk gedung tersebut, seperti pintu masuk ke restoran lain di mal strip mall.

Jika tempat yang ditampilkan adalah gedung itu sendiri, pintu masuk "PREFERRED" akan menjadi pintu masuk yang mengarah ke bagian "utama" gedung. Misalnya, di pusat perbelanjaan, pintu masuk "PREFERRED" akan menjadi pintu masuk yang memungkinkan akses ke area lobi utama, tetapi jika pintu masuk hanya memberikan akses ke toko di sisi gedung, pintu masuk tersebut tidak akan menjadi pintu masuk "PREFERRED".

`structureType`

Jenis struktur yang diwakili oleh tempat ini.

POINT

Lokasi titik.
SECTION

Subbagian dari sebuah bangunan.
BUILDING

Sebuah bangunan.
GROUNDS

Area luas yang biasanya berisi beberapa bangunan, seperti kampus universitas, kompleks apartemen, atau pusat perbelanjaan.

`navigationPoints`

Kolom navigationPoints dalam respons Geocoding berisi daftar titik yang berguna untuk menavigasi ke tempat tersebut. Secara khusus, titik tersebut harus digunakan sebagai titik awal atau akhir saat merutekan di jaringan jalan dari atau ke tempat tersebut.

Setiap titik navigasi berisi nilai berikut:

navigationPointToken adalah token yang berisi informasi kontekstual di kolom navigationPoints. Anda dapat mengirim token ini ke API perutean dan navigasi untuk meningkatkan pengalaman perutean dan sungai di aplikasi Anda. Lihat Merutekan menggunakan token titik navigasi untuk mengetahui informasi selengkapnya.
location berisi nilai lintang dan bujur titik navigasi. Lokasi ini akan selalu sangat dekat dengan jaringan jalan dan mewakili titik berhenti atau titik awal yang ideal untuk menavigasi ke dan dari suatu tempat. Titik tersebut sengaja sedikit diimbangi dari garis tengah jalan untuk menandai sisi jalan tempat tempat tersebut berada.
travelModes adalah daftar mode perjalanan yang dapat diakses dari titik navigasi:
- "DRIVE" adalah mode perjalanan yang sesuai dengan petunjuk arah mengemudi.
- "WALK" adalah mode perjalanan yang sesuai dengan petunjuk arah berjalan kaki.
usages adalah daftar penggunaan yang didukung oleh titik navigasi. Penggunaan dapat berupa:
- "DROPOFF"
- "PICKUP"
- "PARKING"

Untuk penjemputan dan pengantaran, gunakan titik navigasi dengan mode perjalanan DRIVE dan penggunaan PICKUP atau DROPOFF. Jika titik penjemputan atau pengantaran tidak tersedia, gunakan titik navigasi mengemudi teratas.

`arrivalSummary`

Insight yang didukung AI untuk membantu kedatangan. Lihat Ringkasan yang didukung AI.

`landmarks`

Tempat terdekat yang penting untuk membantu pengguna memahami lingkungan sekitar tujuan.

Format respons

SearchDestinations menampilkan SearchDestinationsResponse dalam bentuk JSON berikut:

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "meal_takeaway",
          "food_delivery",
          "american_restaurant",
          "restaurant",
          "food_store",
          "store",
          "food",
          "point_of_interest",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 61.182193756103516,
          "travelDistanceMeters": 63.075645446777344
        },
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "butcher_shop",
              "florist",
              "deli",
              "supermarket",
              "bakery",
              "food_delivery",
              "market",
              "manufacturer",
              "food_store",
              "store",
              "food",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 158.65606689453125,
          "travelDistanceMeters": 131.1669921875
        },
        {
          "place": {
            "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk",
            "displayName": {
              "text": "Oil Changers",
              "languageCode": "en"
            },
            "types": [
              "car_repair",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1240 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743054,
              "longitude": -122.0584272
            }
          },
          "relationalDescription": {
            "text": "Down the road from Oil Changers",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL"
          ],
          "straightLineDistanceMeters": 140.52459716796875,
          "travelDistanceMeters": 143.24220275878906
        },
        {
          "place": {
            "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0",
            "displayName": {
              "text": "Apni Mandi Farmers Market Sunnyvale",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "cake_shop",
              "supermarket",
              "asian_grocery_store",
              "indian_restaurant",
              "meal_takeaway",
              "bakery",
              "manufacturer",
              "wholesaler",
              "restaurant",
              "food_store",
              "store",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1056",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1111 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3737199,
              "longitude": -122.0522958
            }
          },
          "relationalDescription": {
            "text": "Near Apni Mandi Farmers Market Sunnyvale",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 410.37435913085938,
          "travelDistanceMeters": 479.49893188476562
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "primaryType": "chicken_restaurant",
            "types": [
              "chicken_restaurant",
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": {
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ],
              "type": "Polygon"
            }
          },
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 87.348007202148438,
          "travelDistanceMeters": 214.08084106445312
        }
      ],
      "entrances": [
        {
          "location": {
            "latitude": 37.3735328,
            "longitude": -122.05694879999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4",
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "PARKING"
          ]
        }
      ]
    }
  ]
}

Parameter yang diperlukan

Salah satu dari 3 parameter berikut harus ada dalam permintaan API, yang menentukan alamat, tempat, atau lokasi untuk menelusuri tujuan:
- addressQuery - alamat yang akan ditelusuri.
- place - ID tempat yang akan ditelusuri.
- locationQuery - koordinat lintang dan bujur lokasi yang akan ditelusuri.
FieldMask

Tentukan daftar kolom yang akan ditampilkan dalam respons dengan membuat mask kolom respons. Teruskan mask kolom respons ke metode dengan menggunakan parameter URL $fields atau fields, atau dengan menggunakan header HTTP X-Goog-FieldMask. Misalnya, permintaan di bawah ini hanya akan menampilkan pintu masuk, titik navigasi, dan ID tempat tujuan utama.
```
  curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
    -H "X-Goog-Api-Key: API_KEY" \
    -H "Content-Type: application/json" \
    -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
    https://geocode.googleapis.com/v4/geocode/destinations
  
```
Tidak ada daftar kolom default yang ditampilkan dalam respons. Jika Anda menghapus mask kolom, metode akan menampilkan error. Tetapkan mask kolom ke * untuk menampilkan semua kolom. Lihat Memilih kolom yang akan ditampilkan untuk mengetahui detail selengkapnya.

Parameter opsional

travelModes

Menentukan jenis navigationPoints yang akan ditampilkan. Titik navigasi untuk mode perjalanan lainnya akan difilter. Jika travelModes tidak ditetapkan, titik navigasi dari semua mode perjalanan dapat ditampilkan.
languageCode

Bahasa yang akan digunakan untuk menampilkan hasil.
- Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
- Jika languageCode tidak diberikan, API akan menggunakan en sebagai default. Jika Anda menentukan kode bahasa yang tidak valid, API akan menampilkan error INVALID_ARGUMENT.
- API akan berupaya sebaik mungkin untuk memberikan alamat jalan yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API akan menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika diperlukan, dengan memperhatikan bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Semua komponen alamat ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
- Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan kecocokan terdekat.
- Bahasa pilihan memiliki pengaruh kecil pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan hasil tersebut ditampilkan. Geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa, tetapi tidak dalam bahasa lain.
regionCode

Kode wilayah sebagai nilai kode CLDR dua karakter. Tidak ada nilai default. Sebagian besar kode CLDR identik dengan kode ISO 3166-1.
Saat melakukan geocoding alamat, geocoding maju, parameter ini dapat memengaruhi, tetapi tidak sepenuhnya membatasi, hasil dari layanan ke wilayah yang ditentukan. Saat melakukan geocoding lokasi atau tempat, geocoding terbalik atau geocoding tempat, parameter ini dapat digunakan untuk memformat alamat. Dalam semua kasus, parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.
placeFilter

Memungkinkan Anda memfilter hasil penelusuran locationQuery untuk memenuhi persyaratan, seperti hanya menampilkan tujuan yang berupa bangunan atau hanya tujuan yang memiliki alamat yang jelas.

Memfilter berdasarkan granularitas struktural

Filter structureType memungkinkan Anda menentukan jenis struktur yang ditampilkan oleh kueri:
- Mengisolasi Bangunan: Gunakan "structureType": "BUILDING" untuk menampilkan garis luar bangunan di peta atau mendapatkan detail untuk struktur tertentu.
- Memahami Kompleks: Gunakan "structureType": "GROUNDS" untuk memastikan hasil utama adalah keseluruhan area. Hal ini berguna saat membuat kueri untuk area yang lebih luas seperti kampus universitas atau pusat perbelanjaan.
- Berfokus pada Unit/Bagian: Gunakan "structureType": "SECTION" untuk mengidentifikasi bagian dalam bangunan.
Memastikan alamat yang berguna

Tidak semua tempat memiliki alamat tingkat jalan yang jelas. Filter addressability membantu Anda mengontrol kualitas alamat dalam hasil:
- Memerlukan Alamat Utama yang Jelas: Untuk memastikan hasil tujuan utama selalu memiliki alamat atau nama tingkat jalan, gunakan "addressability": "PRIMARY". Hal ini berguna untuk tujuan navigasi atau tampilan yang memerlukan alamat yang jelas
- Mengizinkan Alamat di Sub-Tujuan: Jika tempat utama mungkin tidak memiliki alamat, tetapi unit di dalamnya memiliki alamat (seperti apartemen di gedung), "addressability": "WEAK" memastikan bahwa setidaknya tempat utama atau salah satu sub-tujuannya memiliki alamat.
- Hasil Apa Pun: Jika keberadaan alamat tidak relevan dengan kasus penggunaan Anda, gunakan "addressability": "ANY".
Contoh: Memfilter Bangunan yang Dapat Dialamatkan
```
curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    },
    "placeFilter": {
      "structureType": "BUILDING",
      "addressability": "PRIMARY"
    }
  },
  "languageCode": "en"
}' \\
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
-H "X-Goog-FieldMask: place" \\
https://geocode.googleapis.com/v4/geocode/destinations
```

Menelusuri tujuan Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Permintaan penelusuran tujuan

Menelusuri tujuan berdasarkan alamat

Menelusuri tujuan berdasarkan ID tempat

ID Tempat yang Didukung

Menggunakan Place Autocomplete (Baru) Places API dengan Search Destinations

Menelusuri tujuan berdasarkan lokasi

Menggunakan OAuth untuk membuat permintaan

Respons penelusuran tujuan

primary

containingPlaces

subDestinations

entrances

structureType

navigationPoints

arrivalSummary

landmarks

Format respons

Parameter yang diperlukan

FieldMask

Parameter opsional

travelModes

languageCode

regionCode

placeFilter

Memfilter berdasarkan granularitas struktural

Memastikan alamat yang berguna