Varış noktası arama

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Destination, kullanıcının ulaşmak veya gitmek istediği belirli bir konumu ya da yeri ifade eder. Destination, konum veya yerle ilgili navigasyon noktaları, önemli yerler, girişler ve bina ana hatları gibi bilgileri de içerir.

Geocoding API'nin SearchDestinations yöntemi, adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli hedefler hakkında ayrıntılı bilgi almanızı sağlar.

Varış noktası arama isteği

Varış noktası arama isteği, şu biçimdeki bir URL'ye gönderilen HTTP POST isteğidir:

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

POST isteğinin bir parçası olarak JSON istek gövdesindeki veya üstbilgilerdeki tüm parametreleri iletin. Örneğin:

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

Varış noktası aramak için konumu 3 şekilde belirtebilirsiniz:

  • Adres
  • Yer kimliği
  • Enlem ve boylam koordinatları

Adrese göre varış noktası arama

Adresi yapılandırılmamış bir dize olarak belirtebilirsiniz. Adres coğrafi kodlaması, enlem ve boylam koordinatlarını veya adresleri temsil etmeyen diğer yapılandırılmamış dizeleri çözmez. Bu tür dizelerin kullanıldığı istekler desteklenmez ve hata yanıtlarına veya belirtilmemiş davranışlara yol açabilir. Desteklenmeyen sorgulara örnek olarak aşağıdakiler verilebilir:

Sorgu türü Örnek
Enlem ve boylam koordinatları. Bunun yerine konum sorgusu kullanın. "37.422131,-122.084801"
Tek bir sorguda birden fazla yerin, yolun veya şehrin adı gibi çok fazla kavram ya da kısıtlama olması "Market Street San Francisco San Jose Airport"
Posta adresi öğeleri Google Haritalar'da gösterilmiyor "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
İşletme, zincir veya kategorilerin, bu varlıkların bulunmadığı konumlarla birleştirilmiş adları "Tesco near Dallas, Texas" (Teksas, Dallas yakınlarındaki Tesco)
Birden fazla yorumu olan belirsiz sorgular "Şarj cihazı bırakma"
Artık kullanılmayan eski adlar "Middlesex Birleşik Krallık"
Coğrafi olmayan öğeler veya amaç "Ventura Limanı'nda kaç tekne var?"
Resmi olmayan veya özel adlar "The Jenga"
"The Helter Skelter"
Büyük siyasi varlıklar (şehirler, eyaletler, ülkeler) "New York City"
"California"
"USA"
Belirli adresleri olmayan rotalar "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

veya postalAddress olarak:

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

postalAddress biçimini genellikle bir HTML formunda yakalanan adres bileşenlerini işlerken kullanırsınız.

Yer kimliğine göre hedef arama

Yer kimliği sağlayarak bir hedefi alabilirsiniz:

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

Desteklenen yer kimlikleri

Arama Hedefleri yöntemi, belirli ve gezilebilir hedefleri temsil eden yer kimlikleriyle en iyi sonucu verir. establishment, point_of_interest, premise, street_address ve subpremise gibi türler için yer kimlikleri genellikle desteklenir. Adres aralıklarından (örneğin, "10-20 Main St"), belirli bir numarası olmayan bir rotanın bölümlerinden veya Plus Code'lardan çıkarılanlar gibi ayrı konumları temsil etmeyen yer kimlikleri desteklenmez. Alanı çok büyük olan sonuçlar (ör. "Pasifik Okyanusu") için yer kimlikleri de desteklenmez.

Search Destinations ile Autocomplete (New) özelliğini kullanma

Uyumluluğu sağlamak için Autocomplete (New) özelliğini kullanarak Search Destinations ile kullanılacak yer kimliklerini bulun. Autocomplete (New) özelliğini kullanırken sonuçları türe göre filtrelemek için includedPrimaryTypes parametresini kullanmanız gerekir. Aşağıdaki önerilen filtre kullanılarak Otomatik Tamamlama (Yeni) tarafından döndürülen yer kimlikleri, Arama Hedefleri tarafından desteklenir:

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

Ayrıca, Autocomplete (New) isteğinizde include_pure_service_area_businesses işaretini true olarak ayarlamamanız gerekir.

Konuma göre hedef arama

Enlem ve boylam koordinatlarını girerek bir hedef arayabilirsiniz:

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

İstekte bulunmak için OAuth'u kullanma

Geocoding API v4, kimlik doğrulama için OAuth 2.0'ı destekler. Coğrafi Kodlama API'si ile OAuth'u kullanmak için OAuth jetonuna doğru kapsam atanmalıdır. Geocoding API, Destinations yöntemiyle kullanılmak üzere aşağıdaki kapsamları destekler:

  • https://www.googleapis.com/auth/maps-platform.geocode — Tüm Geocoding API yöntemleriyle kullanın.

Ayrıca, tüm Geocoding API yöntemleri için genel https://www.googleapis.com/auth/cloud-platform kapsamını kullanabilirsiniz. Bu kapsam, tüm yöntemlere erişime izin veren genel bir kapsam olduğundan geliştirme sırasında kullanışlıdır ancak üretimde kullanışlı değildir.

Daha fazla bilgi ve örnek için OAuth'u kullanma başlıklı makaleyi inceleyin.

Arama hedefleri yanıtı

Search Destinations yanıtı, konumla ilgili zengin ve yakın çevreye özel bağlam sağlar.

Search Destinations yanıtındaki PlaceView nesneleri (ör. primary, containingPlaces içindeki öğeler ve landmarks), yer türünü belirtmek için alanları kullanır:

  • types: Yer türlerini belirten bir dizidir.
  • primaryType: Yerleşim yerinin birincil türünü belirten dize.

Hem types hem de primaryType için olası dize değerleri, Yer Türleri (Yeni) sayfasındaki Tablo A ve Tablo B'den alınır.

Bu bölümde, temel yanıt alanları açıklanmaktadır. Tüm yanıt alanlarıyla ilgili ayrıntılı bilgi için API Referansı'na bakın.

primary

İstekteki sorgu tarafından tanımlanan ana yer.

addressComponents

Bu adres için geçerli olan ayrı bileşenleri içeren bir dizi.

Her adres bileşeni genellikle aşağıdaki alanları içerir:

  • types[], adres bileşeninin türünü belirten bir dizidir. Desteklenen türlerin listesine bakın.
  • longText, Geocoder tarafından döndürülen adres bileşeninin tam metin açıklaması veya adıdır.
  • shortText, varsa adres bileşeninin kısaltılmış metin adıdır. Örneğin, Alaska eyaletinin adres bileşeninde iki harfli posta kısaltması kullanılarak longText "Alaska" ve shortText "AK" olabilir.
  • languageCode, bu bileşeni biçimlendirmek için kullanılan dildir (CLDR gösteriminde).

containingPlaces

Birincil hedefin parçası olduğu daha büyük varlıklar (ör. bir mağazanın bulunduğu alışveriş merkezi).

subDestinations

Birincil hedefteki daha ayrıntılı konumlar (örneğin, bir binadaki daireler).

entrances

entrances[] dizisindeki nesneler aşağıdaki alanlara sahiptir:

  • location

    Bir yere giriş ve çıkış noktasının konumunu tanımlayan tek bir enlem/boylam koordinat çifti.

  • entrance_tags[]

    Girişin özelliklerini açıklayan giriş etiketleri dizisi. Aşağıdaki değer desteklenir:

    • "PREFERRED"

    Bu girişin, döndürülen yere fiziksel erişim sağlama olasılığının yüksek olduğunu gösterir. Bir yerin birden fazla tercih edilen girişi olabilir. Bir giriş bu etikete sahip değilse girişin fiziksel olarak aynı binada olduğu ancak mekana erişim sağlamadığı anlamına gelir.

    Örneğin, döndürülen yer bir alışveriş merkezindeki restoransa "PREFERRED" girişleri restoranın kendi girişleri olur. Döndürülen diğer girişler ise binanın diğer girişleri (ör. alışveriş merkezindeki diğer restoranların girişleri) olur.

    Döndürülen yerin kendisi bir binaysa "PREFERRED" girişler, binanın "ana" kısmına giden girişler olur. Örneğin, bir alışveriş merkezinde "PREFERRED" girişleri, ana fuaye alanına erişim sağlayan girişler olacaktır. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa "PREFERRED" girişi olmayacaktır.

  • streetViewThumbnail ve streetViewAnnotation

    Street View Static API için parametreler, bu konumlarla ilgili görüntüleri göstermenize olanak tanır. Bu alanlar hakkında daha fazla bilgi edinin.

structureType

Bu yerin temsil ettiği yapı türü.

  • POINT

    Bir nokta konumu.

  • SECTION

    Bir binanın alt bölümü.

  • BUILDING

    Bina

  • GROUNDS

    Genellikle birden fazla bina içeren geniş bir alan (ör. üniversite kampüsü, apartman kompleksi veya alışveriş merkezi).

Coğrafi kodlama yanıtındaki navigationPoints alanı, yere gitmek için yararlı olan noktaların listesini içerir. Özellikle, bir yerden bir yere yol ağı üzerinde rota oluştururken başlangıç veya bitiş noktası olarak kullanılmalıdır.

Her navigasyon noktası aşağıdaki değerleri içerir:

  • navigationPointToken, navigationPoints alanındaki bağlam bilgilerini içeren bir jetondur. Uygulamanızdaki rota ve nehir deneyimini iyileştirmek için bu jetonu rota ve navigasyon API'lerine gönderebilirsiniz. Daha fazla bilgi için Navigasyon noktası jetonlarını kullanarak rota oluşturma başlıklı makaleyi inceleyin.
  • location, navigasyon noktasının enlem ve boylam değerini içerir. Bu konum her zaman yol ağına çok yakın olur ve bir yere gitmek veya bir yerden gelmek için ideal bir durma ya da başlangıç noktasıdır. Nokta, yerin bulunduğu yol tarafını net bir şekilde işaretlemek için kasıtlı olarak yolun merkez çizgisinden biraz uzağa yerleştirilir.
  • travelModes, navigasyon noktasına erişilebilen seyahat modlarının listesidir:
    • "DRIVE", arabayla yol tariflerine karşılık gelen seyahat modudur.
    • "WALK", yaya yol tariflerine karşılık gelen seyahat modudur.
  • usages, gezinme noktası tarafından desteklenen kullanımların listesidir. Kullanım türleri şunlar olabilir:
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

Teslim alma ve bırakma işlemleri için seyahat modunun DRIVE, kullanımın ise PICKUP veya DROPOFF olduğu navigasyon noktasını kullanın. Teslim alma veya bırakma noktaları yoksa en üstteki sürüş navigasyon noktasını kullanın.

  • altitude_meters, WGS-84 elipsoidine göre navigasyon noktasının metre cinsinden yüksekliğini içerir. Dikey olarak üst üste binen yol segmentlerinin olduğu durumlarda, sisteminizin gitmesi gereken en iyi yol segmentini seçmek için altitude_meters alanını kullanın.

landmarks

Kullanıcıların varış noktasının çevresini anlamasına yardımcı olacak, yakındaki önemli yerler.

Her bir önemli nokta aşağıdaki alanları içerir:

  • place, bu simge yapıyı temsil eden PlaceView nesnesidir.
  • relationalDescription, hedef ile önemli yer arasındaki ilişkiyi açıklayan, kullanıcılar tarafından okunabilir bir açıklamadır. Örneğin, "Empire State Binası'nın yakınında" veya "Beyaz Saray'ın karşısında".
  • tags[], hedef bağlamında önemli yerin nasıl kullanılabileceğini açıklayan bir etiket dizisidir:
    • "ADDRESS": Hedefin yaklaşık konumunu belirlemek için kullanılabilecek, yerel olarak öne çıkan bir yer.
    • "ARRIVAL": Hedefe ulaşmaya yardımcı olmak için kullanılabilen bir yerdir. Hedefe yaklaşıldığında gezinme için faydalıdır.
  • straightLineDistanceMeters, bu önemli noktadan hedefe olan düz çizgi mesafesini metre cinsinden gösterir.
  • travelDistanceMeters, bu önemli noktadan hedefe olan yürüme mesafesini metre cinsinden gösterir.

arrivalSummary

Varış konusunda yardımcı olacak yapay zeka destekli analizler. Yapay zeka destekli özetler başlıklı makaleyi inceleyin.

parkingOptions

Ayrıntılı otopark bilgileri.

Yanıt biçimi

SearchDestinations, aşağıdaki JSON formunun SearchDestinationsResponse değerini döndürür:

{
  "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"
          ]
        }
      ]
    }
  ]
}

Gerekli parametreler

  • Hedef için aranacak adresi, yeri veya konumu belirten aşağıdaki 3 parametreden biri API isteğinde bulunmalıdır:
    • addressQuery: Aranacak adres.
    • place: Aranacak yerin yer kimliği.
    • locationQuery: Aranacak konumun enlem ve boylam koordinatları.

  • FieldMask

    Yanıt alan maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin. $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP üst bilgisini kullanarak yanıt alanı maskesini yönteme iletin. Örneğin, aşağıdaki istek yalnızca birincil varış noktasının girişlerini, navigasyon noktalarını ve yer kimliğini döndürür.

      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

    Yanıtta döndürülen alanların varsayılan bir listesi yoktur. Alan maskesini atlarsanız yöntem bir hata döndürür. Tüm alanları döndürmek için alan maskesini * olarak ayarlayın. Daha fazla bilgi için Döndürülecek alanları seçme başlıklı makaleyi inceleyin.

İsteğe bağlı parametreler

  • travelModes

    Hangi navigationPoints türlerinin döndürüleceğini belirtir. Diğer seyahat modları için navigasyon noktaları filtrelenir. travelModes ayarlanmazsa tüm seyahat modlarının navigasyon noktaları döndürülebilir.

  • languageCode

    Sonuçların döndürüleceği dil.

    • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediğinden bu liste kapsamlı olmayabilir.
    • languageCode sağlanmazsa API, varsayılan olarak konumun yerel dilini ve alfabesini kullanır. Geçersiz bir dil kodu belirtirseniz API, INVALID_ARGUMENT hatası döndürür.
    • API, hem kullanıcı hem de yerel halk tarafından okunabilen bir açık adres sağlamak için elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili dikkate alarak yerel dildeki sokak adreslerini döndürür. Gerekirse bu adresler, kullanıcı tarafından okunabilir bir alfabeye çevrilir. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen dilde döndürülür.
    • Tercih edilen dilde ad yoksa API en yakın eşleşmeyi kullanır.
    • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile göre farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlı kelimeler buna dahildir.

  • regionCode

    Bölge kodu, iki karakterlik CLDR kodu değeri olarak. Varsayılan değer yoktur. Çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır.

    Bir adresi coğrafi olarak kodlarken (ileri coğrafi kodlama) bu parametre, hizmetten gelen sonuçları belirtilen bölgeyle sınırlayabilir ancak tamamen kısıtlamaz. Bir konumun veya yerin coğrafi kodlaması, tersine coğrafi kodlama ya da yer coğrafi kodlaması yapılırken bu parametre, adresi biçimlendirmek için kullanılabilir. Bu parametre, geçerli yasaya göre sonuçları her durumda etkileyebilir.

  • placeFilter

    locationQuery aramasının sonuçlarını, yalnızca binalar olan hedefleri veya yalnızca net adresleri olan hedefleri döndürmek gibi gereksinimlerinizi karşılayacak şekilde filtrelemenize olanak tanır.

    Yapısal ayrıntı düzeyine göre filtreleme

    structureType filtresi, sorgu tarafından döndürülen yapı türlerini belirtmenize olanak tanır:

    • Binaları izole etme: Haritada bina ana hatlarını göstermek veya belirli bir yapıyla ilgili ayrıntıları almak için "structureType": "BUILDING" kullanın.
    • Kompleksleri anlama: Birincil sonucun tüm tesis olmasını sağlamak için "structureType": "GROUNDS" kullanın. Bu, üniversite kampüsleri veya alışveriş merkezleri gibi daha büyük alanları sorgularken kullanışlıdır.
    • Birimlere/Bölümlere Odaklanma: Bir binadaki bölümleri tanımlamak için "structureType": "SECTION" öğesini kullanın.

    Faydalı adresler sağlama

    Bazı yerlerin açık adresleri yoktur. addressability filtresi, sonuçlarınızdaki adreslerin kalitesini kontrol etmenize yardımcı olur:

    • Net bir birincil adres zorunlu kılın: Ana varış noktası sonucunun her zaman sokak düzeyinde bir adresi veya adı olmasını sağlamak için "addressability": "PRIMARY" kullanın. Bu, net bir adresin çok önemli olduğu navigasyon veya görüntüleme amaçları için kullanışlıdır.
    • Alt Hedeflerdeki Adreslere İzin Ver: Birincil yerin adresi olmayabilir ancak içindeki birimlerin (ör. bir binadaki daireler) adresi olabilir. Bu gibi durumlarda "addressability": "WEAK", en azından birincil yerin veya alt hedeflerinden birinin adresinin olmasını sağlar.
    • Herhangi bir sonuç: Adres varlığı kullanım alanınızla alakalı değilse "addressability": "ANY" kullanın. Yalnızca bina ana hatları ve navigasyon noktaları gibi geometrik özelliklere ihtiyacınız olduğunda bu seçeneği kullanmanız önemle tavsiye edilir. Bu seçenek, sonuçların doğruluğunu artırır.
    Örnek: Adreslenebilir binalar için filtreleme 
    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